X (formerly Twitter)

Description: Enable agents to interact with X (formerly Twitter).

Author: Arcade

Auth: User authorization

PyPI VersionLicensePython VersionsWheel StatusDownloads

The Arcade X (formerly Twitter) toolkit provides a pre-built set of tools for interacting with X (formerly Twitter). These tools make it easy to build agents and AI apps that can:

  • Post tweets
  • Reply to tweets
  • Quote tweets
  • Delete tweets
  • Search for tweets by username
  • Search for tweets by keywords
  • Look up a user by username

Available Tools

Tool NameDescription
X.LookupSingleUserByUsernameLook up a user on X (Twitter) by their username.
X.PostTweetPost a tweet to X (Twitter).
X.ReplyToTweetReply to a tweet on X (Twitter).
X.DeleteTweetByIdDelete a tweet on X (Twitter).
X.SearchRecentTweetsByUsernameSearch for recent tweets (last 7 days) on X (Twitter) by username.
X.SearchRecentTweetsByKeywordsSearch for recent tweets (last 7 days) on X (Twitter) by required keywords and phrases.
X.LookupTweetByIdLook up a tweet on X (Twitter) by tweet ID.

If you need to perform an action that’s not listed here, you can get in touch with us to request a new tool, or create your own tools.

X.LookupSingleUserByUsername


Look up a user on X (Twitter) by their username.

Parameters

  • username (string, required) The username of the X (Twitter) user to look up

X.PostTweet


Post a tweet to X (Twitter).

Parameters

  • tweet_text (string, required) The text content of the tweet you want to post
  • quote_tweet_id (string, optional) The ID of the tweet you want to quote. Optional.

X.ReplyToTweet


Reply to a tweet on X (Twitter).

Parameters

  • tweet_id (string, required) The ID of the tweet you want to reply to
  • tweet_text (string, required) The text content of the tweet you want to post
  • quote_tweet_id (string, optional) The ID of the tweet you want to quote. Optional.

X.DeleteTweetById


Delete a tweet on X (Twitter).

Parameters

  • tweet_id (string, required) The ID of the tweet you want to delete

X.SearchRecentTweetsByUsername


Search for recent tweets (last 7 days) on X (Twitter) by username.

Parameters

  • username (string, required) The username of the X (Twitter) user to look up
  • max_results (integer, optional) The maximum number of results to return. Must be in range [1, 100] inclusive
  • next_token (string, optional) The pagination token starting from which to return results

X.SearchRecentTweetsByKeywords


Search for recent tweets (last 7 days) on X (Twitter) by required keywords and phrases.

Parameters

  • keywords (array[string], optional) List of keywords that must be present in the tweet
  • phrases (array[string], optional) List of phrases that must be present in the tweet
  • max_results (integer, optional) The maximum number of results to return. Must be in range [1, 100] inclusive
  • next_token (string, optional) The pagination token starting from which to return results

X.LookupTweetById


Look up a tweet on X (Twitter) by tweet ID.

Parameters

  • tweet_id (string, required) The ID of the tweet you want to look up

Auth

The Arcade X toolkit uses the X auth provider to connect to users’ X accounts. Please refer to the X auth provider documentation to learn how to configure auth.