Skip to main content

​
Overview

X (Twitter) tools allow you to interact with the X platform API to post tweets, retrieve user profiles, search for tweets, and get specific tweet information. These tools provide comprehensive social media integration capabilities.

​
Key Features

  • X_POST: Post tweets to your X account
  • X_GET_USER_PROFILE: Retrieve user profile information
  • X_SEARCH_TWEETS: Search for tweets using queries
  • X_GET_TWEETS: Get specific tweets by ID or criteria

​
Authentication

To use the X API, you need to create a developer account on the X Developer Platform and generate your API keys. This will provide you with the necessary credentials to authenticate your requests. You will need the following keys:
  • consumer_key
  • consumer_secret
  • access_token
  • access_token_secret
Note: Treat API keys as sensitive information and never commit them to public repositories.

​
Tools

​
X_POST

Post tweets to your X account. Input:
  • tweet_text (string, required): Tweet content (max 280 characters)
  • image_base64 (string, optional): Base64 encoded image
  • image_extension (string, optional): Image file extension (jpg, png, etc.)
Output:
  • tweet_id: ID of the posted tweet
  • url: URL of the posted tweet
  • created_at: Timestamp of tweet creation

​
X_GET_USER_PROFILE

Retrieve user profile information from X. Input:
  • username (string): Username to lookup (without @)
Output:
  • User profile information including followers count, bio, verification status, etc.

​
X_SEARCH_TWEETS

Search for tweets using specific queries. Input:
  • query (string, required): Search query
  • max_results (number, optional): Maximum number of results
  • result_type (string, optional): Type of results (“recent”, “popular”, “mixed”)
Output:
  • Array of tweets matching the search criteria

​
X_GET_TWEETS

Retrieve specific tweets by ID. Input:
  • tweet_ids (array, required): Array of tweet IDs to retrieve
Output:
  • Array of tweet objects with detailed information

​
Examples

​
Example: Post a Tweet

- id: post_tweet
  tool: X_POST
  config:
    - name: consumer_key
      value: "{{secrets.TWITTER_CONSUMER_KEY}}"
    - name: consumer_secret
      value: "{{secrets.TWITTER_CONSUMER_SECRET}}"
    - name: access_token
      value: "{{secrets.TWITTER_ACCESS_TOKEN}}"
    - name: access_token_secret
      value: "{{secrets.TWITTER_ACCESS_TOKEN_SECRET}}"
  input:
    - name: tweet_text
      value: "Hello from Jinba Flow! 🚀"
    - name: image_base64
      value: ""
    - name: image_extension
      value: jpg

​
Example: Get User Profile

- id: get_profile
  tool: X_GET_USER_PROFILE
  config:
    - name: consumer_key
      value: "{{secrets.TWITTER_CONSUMER_KEY}}"
    - name: consumer_secret
      value: "{{secrets.TWITTER_CONSUMER_SECRET}}"
    - name: access_token
      value: "{{secrets.TWITTER_ACCESS_TOKEN}}"
    - name: access_token_secret
      value: "{{secrets.TWITTER_ACCESS_TOKEN_SECRET}}"
  input:
    - name: username
      value: "jinbaflow_JP"

​
Example: Search Tweets

- id: search_tweets
  tool: X_SEARCH_TWEETS
  config:
    - name: consumer_key
      value: "{{secrets.TWITTER_CONSUMER_KEY}}"
    - name: consumer_secret
      value: "{{secrets.TWITTER_CONSUMER_SECRET}}"
    - name: access_token
      value: "{{secrets.TWITTER_ACCESS_TOKEN}}"
    - name: access_token_secret
      value: "{{secrets.TWITTER_ACCESS_TOKEN_SECRET}}"
  input:
    - name: query
      value: "workflow automation"
    - name: max_results
      value: 20
    - name: result_type
      value: "popular"

​
Use Cases

  • Social media automation and scheduling
  • Social listening and brand monitoring
  • Customer engagement and support
  • Content amplification and marketing
  • Real-time trend analysis
  • Community management