X (Twitter)

Interact with X (Twitter) API - post tweets, get user profiles, and search tweets

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:

Parameter	Type	Required	Description
tweet_text	string	Yes	Tweet content (max 280 characters)
image_base64	string	No	Base64 encoded image
image_extension	string	No	Image file extension (jpg, png, etc.)

Output:

Field	Type	Description
tweet_id	string	ID of the posted tweet
url	string	URL of the posted tweet
created_at	string	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:

Parameter	Type	Required	Description
query	string	Yes	Search query
max_results	number	No	Maximum number of results
result_type	string	No	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