x.com

•

One-click Login

About Twitter

X (formerly Twitter) is a public social media platform where users post text, images, video, and links in short messages called posts (up to 280 characters on the free tier). It is used by individuals, brands, journalists, and governments for real-time news, audience engagement, and public discourse. Paid tiers add longer posts, reduced ads, a blue verification checkmark, and access to Grok AI. The platform also offers a developer API for programmatic access to posts and user data.

AI Agent Use Cases

- Short-form posts (up to 280 characters free; 10,000+ chars on paid tiers)

- Real-time trending topics and live event coverage

- Blue checkmark verification and ad-revenue sharing (Premium+)

- Grok AI assistant integrated for Premium+ subscribers

- Spaces (live audio rooms) and Communities

- Developer API for reading/writing posts programmatically

Available Actions

These are the specific actions that AI agents can perform with this tool

Find Tweets By Search Query

9 inputs

Returns recent or popular Tweets that match a given search query from the last 7 days.

Inputs

The search query string. May include standard Twitter search operators. This is required and should follow search syntax supported by Twitter (see documentation for available operators).

lang

Restricts tweets to the given language, specified by an ISO 639-1 code (e.g., 'en' for English). Optional.

locale

The 'locale' of the query you are sending, primarily for picking result language. Optional.

result_type

Specifies what type of search results to receive. Defaults to 'mixed'. Options: 'mixed', 'recent', or 'popular'.

count

Number of tweets to return per page. The maximum is 100; the default is 15.

until

Returns tweets created before the given date. Date should be formatted as YYYY-MM-DD. Maximum range: 7 days in the past.

since_id

Returns results with an ID greater than (that is, more recent than) the specified tweet ID.

max_id

Returns results with an ID less than (that is, older than) or equal to the specified tweet ID.

include_entities

If set to true, the response will include the entities node, providing metadata such as hashtags and URLs.

Follow User By Id

1 input

Creates a follow relationship so the authenticated user follows the specified user.

Inputs

user_id

The unique ID of the user that the authenticated user wants to follow. This is required and must be a valid Twitter user ID.

Get Accounts This User Follows

3 inputs

Retrieves the list of user IDs or user profiles that a specified user is following.

Inputs

user_id

The ID of the user whose following (friends) list is being requested.

cursor

A string value to paginate results; pass -1 to retrieve the first page, and use the next_cursor from the previous response for subsequent pages.

count

The maximum number of user IDs or objects to retrieve per request. If not specified, a server default is used (often 20-200).

Search Recent Tweets

7 inputs

Retrieves recent Tweets matching a specified query from the past 7 days.

Inputs

The search query string to match Tweets. Use Twitter’s search operators to refine the results. This parameter must be URL encoded and must not exceed 512 characters.

count

The number of Tweets to return per page, up to a maximum of 100.

result_type

Type of results to retrieve: recent, popular, or both (mixed).

since_id

Returns Tweets with IDs greater than (that is, more recent than) the specified Tweet ID.

max_id

Returns Tweets with IDs less than (that is, older than) or equal to the specified Tweet ID.

lang

Restricts Tweets to the given language.

locale

Specify the language of the query itself (only effective in some languages).

Unfollow Another User

1 input

Stops the authenticated user from following a specified user on Twitter/X.

Inputs

user_id

The unique identifier of the user to unfollow. This should be the string user ID of the account to remove from the authenticated user's following list.

About Twitter

AI Agent Use Cases

- Short-form posts (up to 280 characters free; 10,000+ chars on paid tiers)

- Real-time trending topics and live event coverage

- Blue checkmark verification and ad-revenue sharing (Premium+)

- Grok AI assistant integrated for Premium+ subscribers

- Spaces (live audio rooms) and Communities

- Developer API for reading/writing posts programmatically

Available Actions

These are the specific actions that AI agents can perform with this tool

Find Tweets By Search Query

9 inputs

Returns recent or popular Tweets that match a given search query from the last 7 days.

Inputs

The search query string. May include standard Twitter search operators. This is required and should follow search syntax supported by Twitter (see documentation for available operators).

lang

Restricts tweets to the given language, specified by an ISO 639-1 code (e.g., 'en' for English). Optional.

locale

The 'locale' of the query you are sending, primarily for picking result language. Optional.

result_type

Specifies what type of search results to receive. Defaults to 'mixed'. Options: 'mixed', 'recent', or 'popular'.

count

Number of tweets to return per page. The maximum is 100; the default is 15.

until

Returns tweets created before the given date. Date should be formatted as YYYY-MM-DD. Maximum range: 7 days in the past.

since_id

Returns results with an ID greater than (that is, more recent than) the specified tweet ID.

max_id

Returns results with an ID less than (that is, older than) or equal to the specified tweet ID.

include_entities

If set to true, the response will include the entities node, providing metadata such as hashtags and URLs.

Follow User By Id

1 input

Creates a follow relationship so the authenticated user follows the specified user.

Inputs

user_id

The unique ID of the user that the authenticated user wants to follow. This is required and must be a valid Twitter user ID.

Get Accounts This User Follows

3 inputs

Retrieves the list of user IDs or user profiles that a specified user is following.

Inputs

user_id

The ID of the user whose following (friends) list is being requested.

cursor

A string value to paginate results; pass -1 to retrieve the first page, and use the next_cursor from the previous response for subsequent pages.

count

The maximum number of user IDs or objects to retrieve per request. If not specified, a server default is used (often 20-200).

Search Recent Tweets

7 inputs

Retrieves recent Tweets matching a specified query from the past 7 days.

Inputs

The search query string to match Tweets. Use Twitter’s search operators to refine the results. This parameter must be URL encoded and must not exceed 512 characters.

count

The number of Tweets to return per page, up to a maximum of 100.

result_type

Type of results to retrieve: recent, popular, or both (mixed).

since_id

Returns Tweets with IDs greater than (that is, more recent than) the specified Tweet ID.

max_id

Returns Tweets with IDs less than (that is, older than) or equal to the specified Tweet ID.

lang

Restricts Tweets to the given language.

locale

Specify the language of the query itself (only effective in some languages).

Unfollow Another User

1 input

Stops the authenticated user from following a specified user on Twitter/X.

Inputs

user_id

The unique identifier of the user to unfollow. This should be the string user ID of the account to remove from the authenticated user's following list.