← Hootsuite + X (Twitter) integrations

Search Tweets with X (Twitter) API on New Post Created from Hootsuite API

Pipedream makes it easy to connect APIs for X (Twitter), Hootsuite and 2,200+ other apps remarkably fast.

Trigger workflow on
New Post Created from the Hootsuite API
Next, do this
Search Tweets with the X (Twitter) API
No credit card required
Intro to Pipedream
Watch us build a workflow
Watch us build a workflow
8 min
Watch now ➜

Trusted by 1,000,000+ developers from startups to Fortune 500 companies

Adyen logo
Appcues logo
Bandwidth logo
Checkr logo
ChartMogul logo
Dataminr logo
Gopuff logo
Gorgias logo
LinkedIn logo
Logitech logo
Replicated logo
Rudderstack logo
SAS logo
Scale AI logo
Webflow logo
Warner Bros. logo
Adyen logo
Appcues logo
Bandwidth logo
Checkr logo
ChartMogul logo
Dataminr logo
Gopuff logo
Gorgias logo
LinkedIn logo
Logitech logo
Replicated logo
Rudderstack logo
SAS logo
Scale AI logo
Webflow logo
Warner Bros. logo

Developers Pipedream

Getting Started

This integration creates a workflow with a Hootsuite trigger and X (Twitter) action. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

  1. Select this integration
  2. Configure the New Post Created trigger
    1. Connect your Hootsuite account
    2. Configure timer
    3. Select one or more States
  3. Configure the Search Tweets action
    1. Connect your X (Twitter) account
    2. Configure Query
    3. Optional- Configure Max Results
  4. Deploy the workflow
  5. Send a test event to validate your setup
  6. Turn on the trigger

Details

This integration uses pre-built, source-available components from Pipedream's GitHub repo. These components are developed by Pipedream and the community, and verified and maintained by Pipedream.

To contribute an update to an existing component or create a new component, create a PR on GitHub. If you're new to Pipedream component development, you can start with quickstarts for trigger span and action development, and then review the component API reference.

Trigger

Description:Emit new event on each new created post. [See docs here](https://platform.hootsuite.com/docs/api/index.html#operation/retrieveMessages).
Version:0.0.1
Key:hootsuite-new-post-created

Hootsuite Overview

The Hootsuite API offers a variety of endpoints to automate social media management tasks such as scheduling posts, managing social content, and analyzing social media performance. By leveraging Pipedream, you can create serverless workflows to interact with the Hootsuite API; you can schedule posts at optimal times, aggregate metrics for reporting, or even respond to social media activity in real-time. Pipedream's platform allows the seamless integration of the Hootsuite API with hundreds of other apps to streamline social media workflows, monitor brand presence, and engage with audiences effectively.

Trigger Code

import dayjs from "dayjs";
import hootsuite from "../../hootsuite.app.mjs";
import constants from "../common/constants.mjs";
import { DEFAULT_POLLING_SOURCE_TIMER_INTERVAL } from "@pipedream/platform";

export default {
  name: "New Post Created",
  version: "0.0.1",
  key: "hootsuite-new-post-created",
  description: "Emit new event on each new created post. [See docs here](https://platform.hootsuite.com/docs/api/index.html#operation/retrieveMessages).",
  type: "source",
  dedupe: "unique",
  props: {
    hootsuite,
    db: "$.service.db",
    timer: {
      type: "$.interface.timer",
      static: {
        intervalSeconds: DEFAULT_POLLING_SOURCE_TIMER_INTERVAL,
      },
    },
    states: {
      label: "States",
      description: "Selected the states to filter",
      options: constants.STATES,
      type: "string[]",
    },
  },
  methods: {
    emitEvent(data) {
      if (!this.states.includes(data.state)) {
        return;
      }

      this.$emit(data, {
        id: data.id,
        summary: `New post created with ID ${data.id}`,
        ts: new Date(),
      });
    },
    _setLastSyncTimestamp() {
      this.db.set("lastSyncTimestamp", dayjs().toISOString());
    },
    _getLastSyncTimestamp() {
      return this.db.get("lastSyncTimestamp");
    },
  },
  hooks: {
    async deploy() {
      this._setLastSyncTimestamp();

      const { data: posts } = await this.hootsuite.getPosts({
        params: {
          startTime: new Date(new Date().setDate(new Date().getDate() - 7)).toISOString(),
          endTime: new Date().toISOString(),
        },
      });

      posts.forEach(this.emitEvent);
    },
  },
  async run() {
    const lastSyncTimestamp = this._getLastSyncTimestamp();
    this._setLastSyncTimestamp();

    const { data: posts } = await this.hootsuite.getPosts({
      params: {
        startTime: dayjs(lastSyncTimestamp).subtract(24, "hour")
          .toISOString(),
        endTime: dayjs().add(24, "hour")
          .toISOString(),
      },
    });

    console.log({
      startTime: dayjs(lastSyncTimestamp).subtract(24, "hour")
        .toISOString(),
      endTime: dayjs().toISOString(),
    });

    posts.forEach(this.emitEvent);
  },
};

Trigger Configuration

This component may be configured based on the props defined in the component code. Pipedream automatically prompts for input values in the UI and CLI.
LabelPropTypeDescription
HootsuitehootsuiteappThis component uses the Hootsuite app.
N/Adb$.service.dbThis component uses $.service.db to maintain state between executions.
timer$.interface.timer
Statesstatesstring[]Select a value from the drop down menu:{ "label": "Scheduled", "value": "SCHEDULED" }{ "label": "Submitted", "value": "SUBMITTED" }{ "label": "Pending Approval", "value": "PENDING_APPROVAL" }{ "label": "Sent", "value": "SENT" }{ "label": "Send Failed Permanently", "value": "SEND_FAILED_PERMANENTLY" }{ "label": "Rejected", "value": "REJECTED" }

Trigger Authentication

Hootsuite uses OAuth authentication. When you connect your Hootsuite account, Pipedream will open a popup window where you can sign into Hootsuite and grant Pipedream permission to connect to your account. Pipedream securely stores and automatically refreshes the OAuth tokens so you can easily authenticate any Hootsuite API.

Pipedream requests the following authorization scopes when you connect your account:

offline

About Hootsuite

Social media management platform.

Action

Description:Retrieve Tweets from the last seven days that match a query. [See the documentation](https://developer.twitter.com/en/docs/twitter-api/tweets/search/api-reference/get-tweets-search-recent)
Version:2.0.8
Key:twitter-simple-search

X (Twitter) Overview

The Twitter API on Pipedream enables you to automate interactions with Twitter, from posting tweets to analyzing social media trends. Pipedream's serverless platform provides the tools to create workflows that trigger on specific Twitter activities, process data, and connect with countless other apps for extensive automation scenarios. With Pipedream's integration, you can listen for events such as new tweets, mentions, or followers, and execute actions like tweeting, retweeting, or even leveraging sentiment analysis to gauge public perception.

Action Code

import common from "../../common/appValidation.mjs";
import { ACTION_ERROR_MESSAGE } from "../../common/errorMessage.mjs";
import { defineAction } from "@pipedream/types";
import { getMultiItemSummary, getTweetFields, } from "../../common/methods.mjs";
export const DOCS_LINK = "https://developer.twitter.com/en/docs/twitter-api/tweets/search/api-reference/get-tweets-search-recent";
const MIN_RESULTS = 10;
const DEFAULT_RESULTS = 10;
export const MAX_RESULTS_PER_PAGE = 100;
export default defineAction({
    ...common,
    key: "twitter-simple-search",
    name: "Search Tweets",
    description: `Retrieve Tweets from the last seven days that match a query. [See the documentation](${DOCS_LINK})`,
    version: "2.0.8",
    type: "action",
    props: {
        ...common.props,
        query: {
            propDefinition: [
                common.props.app,
                "query",
            ],
        },
        maxResults: {
            propDefinition: [
                common.props.app,
                "maxResults",
            ],
            min: MIN_RESULTS,
            description: `Maximum amount of items to return. Each request can return up to ${MAX_RESULTS_PER_PAGE} items.`,
            default: DEFAULT_RESULTS,
        },
    },
    methods: {
        ...common.methods,
        getMultiItemSummary,
        getTweetFields,
    },
    async run({ $ }) {
        const params = {
            $,
            maxPerPage: MAX_RESULTS_PER_PAGE,
            maxResults: this.maxResults,
            params: {
                query: this.query,
                ...this.getTweetFields(),
            },
            fallbackError: ACTION_ERROR_MESSAGE,
        };
        const response = await this.app.searchTweets(params);
        $.export("$summary", this.getMultiItemSummary("tweet", response.data?.length));
        return response;
    },
});

Action Configuration

This component may be configured based on the props defined in the component code. Pipedream automatically prompts for input values in the UI.

LabelPropTypeDescription
X (Twitter)appappThis component uses the X (Twitter) app.
Queryquerystring

One query for matching Tweets. See the Twitter API guide on building queries.

Max ResultsmaxResultsinteger

Maximum amount of items to return. Each request can return up to 100 items.

Action Authentication

X (Twitter) uses OAuth authentication. When you connect your X (Twitter) account, Pipedream will open a popup window where you can sign into X (Twitter) and grant Pipedream permission to connect to your account. Pipedream securely stores and automatically refreshes the OAuth tokens so you can easily authenticate any X (Twitter) API.

Pipedream requests the following authorization scopes when you connect your account:

About X (Twitter)

Formerly known as Twitter. From breaking news and entertainment to sports and politics, get the full story with all the live commentary. Use a X developer app you've created to send API requests.

More Ways to Connect X (Twitter) + Hootsuite

Add User To List with Twitter API on New Post Created from Hootsuite API
Hootsuite + X (Twitter)
 
Try it
Create Tweet with Twitter API on New Post Created from Hootsuite API
Hootsuite + X (Twitter)
 
Try it
Delete Tweet with Twitter API on New Post Created from Hootsuite API
Hootsuite + X (Twitter)
 
Try it
Follow User with Twitter API on New Post Created from Hootsuite API
Hootsuite + X (Twitter)
 
Try it
Get Tweet with Twitter API on New Post Created from Hootsuite API
Hootsuite + X (Twitter)
 
Try it
New Post Created from the Hootsuite API

Emit new event on each new created post. See docs here.

 
Try it
New Follower Received by User from the X (Twitter) API

Emit new event when the specified User receives a Follower See the documentation

 
Try it
New List Followed by User from the X (Twitter) API

Emit new event when the specified User follows a List See the documentation

 
Try it
New Mention Received by User from the X (Twitter) API

Emit new event when the specified User is mentioned in a Tweet See the documentation

 
Try it
New Message Received from the X (Twitter) API

Emit new event when a new Direct Message (DM) is received See the documentation

 
Try it
Search Tweets with the X (Twitter) API

Retrieve Tweets from the last seven days that match a query. See the documentation

 
Try it
Add User To List with the X (Twitter) API

Add a member to a list owned by the user. See the documentation

 
Try it
Create Tweet with the X (Twitter) API

Create a new tweet. See the documentation

 
Try it
Delete Tweet with the X (Twitter) API

Remove a posted tweet. See the documentation

 
Try it
Follow User with the X (Twitter) API

Follow a user. See the documentation

 
Try it

Explore Other Apps

1
-
24
of
2,200+
apps by most popular

HTTP / Webhook
HTTP / Webhook
Get a unique URL where you can send HTTP or webhook requests
Node
Node
Anything you can do with Node.js, you can do in a Pipedream workflow. This includes using most of npm's 400,000+ packages.
Python
Python
Anything you can do in Python can be done in a Pipedream Workflow. This includes using any of the 350,000+ PyPi packages available in your Python powered workflows.
OpenAI (ChatGPT)
OpenAI (ChatGPT)
OpenAI is an AI research and deployment company with the mission to ensure that artificial general intelligence benefits all of humanity. They are the makers of popular models like ChatGPT, DALL-E, and Whisper.
Premium
Salesforce
Salesforce
Web services API for interacting with Salesforce
Premium
HubSpot
HubSpot
HubSpot's CRM platform contains the marketing, sales, service, operations, and website-building software you need to grow your business.
Premium
Zoho CRM
Zoho CRM
Zoho CRM is an online Sales CRM software that manages your sales, marketing, and support in one CRM platform.
Premium
Stripe
Stripe
Stripe powers online and in-person payment processing and financial solutions for businesses of all sizes.
Shopify
Shopify
Shopify is a complete commerce platform that lets anyone start, manage, and grow a business. You can use Shopify to build an online store, manage sales, market to customers, and accept payments in digital and physical locations.
Premium
WooCommerce
WooCommerce
WooCommerce is the open-source ecommerce platform for WordPress.
Premium
Snowflake
Snowflake
A data warehouse built for the cloud
Premium
MongoDB
MongoDB
MongoDB is an open source NoSQL database management program.
Supabase
Supabase
Supabase is an open source Firebase alternative.
MySQL
MySQL
MySQL is an open-source relational database management system.
PostgreSQL
PostgreSQL
PostgreSQL is a free and open-source relational database management system emphasizing extensibility and SQL compliance.
Premium
AWS
AWS
Amazon Web Services (AWS) offers reliable, scalable, and inexpensive cloud computing services.
Premium
Twilio SendGrid
Twilio SendGrid
Send marketing and transactional email through the Twilio SendGrid platform with the Email API, proprietary mail transfer agent, and infrastructure for scalable delivery.
Amazon SES
Amazon SES
Amazon SES is a cloud-based email service provider that can integrate into any application for high volume email automation
Premium
Klaviyo
Klaviyo
Email Marketing and SMS Marketing Platform
Premium
Zendesk
Zendesk
Zendesk is award-winning customer service software trusted by 200K+ customers. Make customers happy via text, mobile, phone, email, live chat, social media.
Notion
Notion
Notion is a new tool that blends your everyday work apps into one. It's the all-in-one workspace for you and your team.
Slack
Slack
Slack is a channel-based messaging platform. With Slack, people can work together more effectively, connect all their software tools and services, and find the information they need to do their best work — all within a secure, enterprise-grade environment.
Microsoft Teams
Microsoft Teams
Microsoft Teams has communities, events, chats, channels, meetings, storage, tasks, and calendars in one place.
Schedule
Schedule
Trigger workflows on an interval or cron schedule.