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.

• X_POST uses OAuth 1.0a user-context credentials (config): consumer_key, consumer_secret, access_token, access_token_secret
• X_GET_USER_PROFILE, X_SEARCH_TWEETS, and X_GET_TWEETS use an app-only OAuth 2.0 Bearer token (config): bearer_token

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	The text of the tweet

Output:

Field	Type	Description
tweet.id	string	ID of the posted tweet
tweet.text	string	Text of the posted tweet

X_GET_USER_PROFILE

Retrieve user profile information from X.

Input:

• username (string, required): Username to lookup (without @)

Output:

A user object with id, username, name, and (when available) description, location, url, verified, followers_count, following_count, tweet_count, created_at, and profile_image_url.

X_SEARCH_TWEETS

Search for tweets using specific queries.

Input:

Parameter	Type	Required	Description
query	string	Yes	Search query
count	number	No	Number of tweets to retrieve (1-100, default: 10)
result_type	string	No	Type of results: recent, popular, mixed (default: recent)
include_entities	boolean	No	Include entities such as hashtags, mentions, and URLs (default: false)

Output:

A tweets array. Each tweet has id, text, created_at, author, and optional public_metrics (retweet_count, like_count, reply_count) and entities (hashtags, mentions, urls).

X_GET_TWEETS

Retrieve recent tweets from a user’s timeline.

Input:

Parameter	Type	Required	Description
username	string	Yes	Twitter username (without @)
count	number	No	Number of tweets to retrieve (1-100, default: 10)
include_replies	boolean	No	Include replies in the results (default: false)
include_retweets	boolean	No	Include retweets in the results (default: false)

Output:

A tweets array. Each tweet has id, text, created_at, author (username, name), and optional public_metrics (retweet_count, like_count, reply_count).

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! 🚀"

Example: Get User Profile

- id: get_profile
  tool: X_GET_USER_PROFILE
  config:
    - name: bearer_token
      value: "{{secrets.TWITTER_BEARER_TOKEN}}"
  input:
    - name: username
      value: "jinbaflow_JP"

Example: Search Tweets

- id: search_tweets
  tool: X_SEARCH_TWEETS
  config:
    - name: bearer_token
      value: "{{secrets.TWITTER_BEARER_TOKEN}}"
  input:
    - name: query
      value: "workflow automation"
    - name: count
      value: 20

Example: Get a User’s Tweets

- id: get_tweets
  tool: X_GET_TWEETS
  config:
    - name: bearer_token
      value: "{{secrets.TWITTER_BEARER_TOKEN}}"
  input:
    - name: username
      value: "jinbaflow_JP"
    - name: count
      value: 10
    - name: include_retweets
      value: false

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