X (Twitter) Trends MCP
ai.trendsmcp/x-twitter
80 toolsauthHTTPregistry active
Summary
Pulls Twitter and Google Search trend data into your Claude or Cursor workspace through a simple MCP integration. You get time series for any keyword, growth rates, and multi-source comparisons without scraping or managing browser sessions. The free tier gives you 100 requests per month, which is enough for occasional checks or weekly batch jobs. The API returns clean JSON with date/value pairs, and the MCP config drops into Claude Desktop or Cursor in under a minute. Reach for this when you need to ground a conversation in actual search momentum or compare buzz across platforms without opening twelve tabs.
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Tools
Public tool metadata for what this MCP can expose to an agent.
80 tools
chat.conversations.listList chat conversations for authenticated user5 params
List chat conversations for authenticated user
Parameters* required
chat_conversation.fieldsarrayA comma separated list of ChatConversation fields to display.
expansionsarrayA comma separated list of fields to expand.
max_resultsintegerMaximum number of conversations to return.default: 10
pagination_tokenstringToken for pagination to retrieve the next page of results.
user.fieldsarrayA comma separated list of User fields to display.
chat.conversations.getGet chat conversation by ID4 params
Get chat conversation by ID
Parameters* required
chat_message_event.fieldsarrayA comma separated list of ChatMessageEvent fields to display.
conversation_idstringThe Chat conversation ID.
max_resultsintegerMaximum number of message events to return.default: 10
pagination_tokenstringToken for pagination to retrieve the next page of results.
chat.conversations.messages.createSend message in chat conversation5 params
Send message in chat conversation
Parameters* required
conversation_idstringThe Chat conversation ID.
conversation_tokenstringOptional conversation token.
encoded_message_create_eventstringBase64-encoded Thrift MessageCreateEvent containing encrypted message contents.
encoded_message_event_signaturestringBase64-encoded Thrift MessageEventSignature for message verification.
message_idstringUnique identifier for this message.
chat.conversations.read.createMark chat conversation as read2 params
Mark chat conversation as read
Parameters* required
conversation_idstringThe Chat conversation ID.
seen_until_sequence_idstringThe sequence ID of the last message to mark as read up to.
chat.conversations.typing.createSend typing indicator in chat conversation1 params
Send typing indicator in chat conversation
Parameters* required
conversation_idstringThe Chat conversation ID.
chat.media.getDownload media from chat conversation2 params
Download media from chat conversation
Parameters* required
conversation_idstringThe Chat conversation ID.
media_hash_keystringThe media hash key returned from the upload initialize step.
communities.search.listSearch communities by keyword5 params
Search communities by keyword
Parameters* required
community.fieldsarrayA comma separated list of Community fields to display.
max_resultsintegerThe maximum number of search results to be returned by a request.default: 10
next_tokenstringThis parameter is used to get the next 'page' of results. The value used with the parameter is pulled directly from the response provided by the API, and should not be modified.
pagination_tokenstringThis parameter is used to get the next 'page' of results. The value used with the parameter is pulled directly from the response provided by the API, and should not be modified.
querystringQuery to search communities.
communities.getGet community details by ID2 params
Get community details by ID
Parameters* required
community.fieldsarrayA comma separated list of Community fields to display.
idstringThe ID of the Community.
dm_conversations.createCreate new DM conversation with participants3 params
Create new DM conversation with participants
Parameters* required
conversation_typestringThe conversation type that is being created.one of
Groupmessagevalueparticipant_idsarrayParticipants for the DM Conversation.
dm_conversations.with.dm_events.listList DM events with specific participant9 params
List DM events with specific participant
Parameters* required
dm_event.fieldsarrayA comma separated list of DmEvent fields to display.
event_typesarrayThe set of event_types to include in the results.
expansionsarrayA comma separated list of fields to expand.
max_resultsintegerThe maximum number of results.default: 100
media.fieldsarrayA comma separated list of Media fields to display.
pagination_tokenstringThis parameter is used to get a specified 'page' of results.
participant_idstringThe ID of the participant user for the One to One DM conversation.
tweet.fieldsarrayA comma separated list of Tweet fields to display.
user.fieldsarrayA comma separated list of User fields to display.
dm_conversations.with.messages.createSend DM to participant by user ID1 params
Send DM to participant by user ID
Parameters* required
participant_idstringThe ID of the recipient user that will receive the DM.
dm_conversations.messages.createSend DM in existing conversation by ID1 params
Send DM in existing conversation by ID
Parameters* required
dm_conversation_idstringThe DM Conversation ID.
dm_conversations.dm_events.listList DM events in conversation by ID9 params
List DM events in conversation by ID
Parameters* required
dm_event.fieldsarrayA comma separated list of DmEvent fields to display.
event_typesarrayThe set of event_types to include in the results.
expansionsarrayA comma separated list of fields to expand.
idstringThe DM conversation ID.
max_resultsintegerThe maximum number of results.default: 100
media.fieldsarrayA comma separated list of Media fields to display.
pagination_tokenstringThis parameter is used to get a specified 'page' of results.
tweet.fieldsarrayA comma separated list of Tweet fields to display.
user.fieldsarrayA comma separated list of User fields to display.
dm_events.listList all DM events for authenticated user8 params
List all DM events for authenticated user
Parameters* required
dm_event.fieldsarrayA comma separated list of DmEvent fields to display.
event_typesarrayThe set of event_types to include in the results.
expansionsarrayA comma separated list of fields to expand.
max_resultsintegerThe maximum number of results.default: 100
media.fieldsarrayA comma separated list of Media fields to display.
pagination_tokenstringThis parameter is used to get a specified 'page' of results.
tweet.fieldsarrayA comma separated list of Tweet fields to display.
user.fieldsarrayA comma separated list of User fields to display.
dm_events.getGet DM event details by ID6 params
Get DM event details by ID
Parameters* required
dm_event.fieldsarrayA comma separated list of DmEvent fields to display.
event_idstringdm event id.
expansionsarrayA comma separated list of fields to expand.
media.fieldsarrayA comma separated list of Media fields to display.
tweet.fieldsarrayA comma separated list of Tweet fields to display.
user.fieldsarrayA comma separated list of User fields to display.
dm_events.deleteDelete DM event by ID1 params
Delete DM event by ID
Parameters* required
event_idstringThe ID of the direct-message event to delete.
evaluate_note.createSubmit evaluation for a Community Note2 params
Submit evaluation for a Community Note
Parameters* required
note_textstringText for the community note.
post_idstringUnique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.
insights.28hr.listGet post engagement insights for last 28 hours4 params
Get post engagement insights for last 28 hours
Parameters* required
engagement.fieldsarrayA comma separated list of Engagement fields to display.
granularitystringgranularity of metrics response.one of
Daily · Hourly · Weekly · Totalrequested_metricsarrayrequest metrics for historical request.
tweet_idsarrayList of PostIds for 28hr metrics.
insights.historical.listGet historical post engagement insights6 params
Get historical post engagement insights
Parameters* required
end_timestringYYYY-MM-DDTHH:mm:ssZ. The UTC timestamp representing the end of the time range.
engagement.fieldsarrayA comma separated list of Engagement fields to display.
granularitystringgranularity of metrics response.one of
Daily · Hourly · Weekly · Totalrequested_metricsarrayrequest metrics for historical request.
start_timestringYYYY-MM-DDTHH:mm:ssZ. The UTC timestamp representing the start of the time range.
tweet_idsarrayList of PostIds for historical metrics.
lists.createCreate new list3 params
Create new list
Parameters* required
descriptionstringnamestringprivatebooleandefault: false
lists.getGet list details by ID4 params
Get list details by ID
Parameters* required
expansionsarrayA comma separated list of fields to expand.
idstringThe ID of the List.
list.fieldsarrayA comma separated list of List fields to display.
user.fieldsarrayA comma separated list of User fields to display.
lists.updateUpdate list name or description4 params
Update list name or description
Parameters* required
descriptionstringidstringThe ID of the List to modify.
namestringprivatebooleanlists.deleteDelete list by ID1 params
Delete list by ID
Parameters* required
idstringThe ID of the List to delete.
lists.members.listList members of a list6 params
List members of a list
Parameters* required
expansionsarrayA comma separated list of fields to expand.
idstringThe ID of the List.
max_resultsintegerThe maximum number of results.default: 100
pagination_tokenstringThis parameter is used to get a specified 'page' of results.
tweet.fieldsarrayA comma separated list of Tweet fields to display.
user.fieldsarrayA comma separated list of User fields to display.
lists.members.createAdd member to list2 params
Add member to list
Parameters* required
idstringThe ID of the List for which to add a member.
user_idstringUnique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.
lists.members.deleteRemove member from list2 params
Remove member from list
Parameters* required
idstringThe ID of the List to remove a member.
user_idstringThe ID of User that will be removed from the List.
lists.tweets.listGet posts from a list timeline9 params
Get posts from a list timeline
Parameters* required
expansionsarrayA comma separated list of fields to expand.
idstringThe ID of the List.
max_resultsintegerThe maximum number of results.default: 100
media.fieldsarrayA comma separated list of Media fields to display.
pagination_tokenstringThis parameter is used to get the next 'page' of results.
place.fieldsarrayA comma separated list of Place fields to display.
poll.fieldsarrayA comma separated list of Poll fields to display.
tweet.fieldsarrayA comma separated list of Tweet fields to display.
user.fieldsarrayA comma separated list of User fields to display.
media.listGet media details by media keys2 params
Get media details by media keys
Parameters* required
media.fieldsarrayA comma separated list of Media fields to display.
media_keysarrayA comma separated list of Media Keys. Up to 100 are allowed in a single request.
media.analytics.listGet media engagement analytics5 params
Get media engagement analytics
Parameters* required
end_timestringYYYY-MM-DDTHH:mm:ssZ. The UTC timestamp representing the end of the time range.
granularitystringThe granularity for the search counts results.one of
hourly · daily · totaldefault: dailymedia_analytics.fieldsarrayA comma separated list of MediaAnalytics fields to display.
media_keysarrayA comma separated list of Media Keys. Up to 100 are allowed in a single request.
start_timestringYYYY-MM-DDTHH:mm:ssZ. The UTC timestamp representing the start of the time range.
media.metadata.createSet alt text or metadata on uploaded media2 params
Set alt text or metadata on uploaded media
Parameters* required
idstringThe unique identifier of this Media.
metadataobjectmedia.subtitles.createAdd subtitles to media3 params
Add subtitles to media
Parameters* required
idstringThe unique identifier of this Media.
media_categorystringThe media category of uploaded media to which subtitles should be added/deletedone of
AmplifyVideo · TweetVideosubtitlesobjectmedia.subtitles.deleteRemove subtitles from media3 params
Remove subtitles from media
Parameters* required
idstringThe unique identifier of this Media.
language_codestringThe language code should be a BCP47 code (e.g. 'EN", "SP")
media_categorystringThe media category of uploaded media to which subtitles should be added/deletedone of
AmplifyVideo · TweetVideomedia.getGet media details by single media key2 params
Get media details by single media key
Parameters* required
media.fieldsarrayA comma separated list of Media fields to display.
media_keystringA single Media Key.
news.search.listSearch news stories by keyword4 params
Search news stories by keyword
Parameters* required
max_age_hoursintegerThe maximum age of the News story to search for.default: 168
max_resultsintegerThe number of results to return.default: 10
news.fieldsarrayA comma separated list of News fields to display.
querystringThe search query.
news.getGet news story details by ID2 params
Get news story details by ID
Parameters* required
idstringThe ID of the news story.
news.fieldsarrayA comma separated list of News fields to display.
notes.createCreate Community Note on a post3 params
Create Community Note on a post
Parameters* required
infoobjectA X Community Note is a note on a Post.
post_idstringUnique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.
test_modebooleanIf true, the note being submitted is only for testing the capability of the bot, and won't be publicly visible. If false, the note being submitted will be a new proposed note on the product.
notes.search.notes_written.listSearch Community Notes written by user4 params
Search Community Notes written by user
Parameters* required
max_resultsintegerMax results to return.default: 10
note.fieldsarrayA comma separated list of Note fields to display.
pagination_tokenstringPagination token to get next set of posts eligible for notes.
test_modebooleanIf true, return the notes the caller wrote for the test. If false, return the notes the caller wrote on the product.
notes.search.posts_eligible_for_notes.listSearch posts eligible for Community Notes10 params
Search posts eligible for Community Notes
Parameters* required
expansionsarrayA comma separated list of fields to expand.
max_resultsintegerMax results to return.default: 10
media.fieldsarrayA comma separated list of Media fields to display.
pagination_tokenstringPagination token to get next set of posts eligible for notes.
place.fieldsarrayA comma separated list of Place fields to display.
poll.fieldsarrayA comma separated list of Poll fields to display.
post_selectionstringThe selection of posts to return. Valid values are 'feed_size: [small|large|xl], feed_lang: [en|es|...|all]'. Default (if not specified) is 'feed_size: small, feed_lang: en'. Only top AI writers ha...
test_modebooleanIf true, return a list of posts that are for the test. If false, return a list of posts that the bots can write proposed notes on the product.
tweet.fieldsarrayA comma separated list of Tweet fields to display.
user.fieldsarrayA comma separated list of User fields to display.
notes.deleteDelete Community Note by ID1 params
Delete Community Note by ID
Parameters* required
idstringThe community note id to delete.
spaces.listGet spaces by IDs5 params
Get spaces by IDs
Parameters* required
expansionsarrayA comma separated list of fields to expand.
idsarrayThe list of Space IDs to return.
space.fieldsarrayA comma separated list of Space fields to display.
topic.fieldsarrayA comma separated list of Topic fields to display.
user.fieldsarrayA comma separated list of User fields to display.
spaces.by.creator_ids.listGet spaces created by specific users5 params
Get spaces created by specific users
Parameters* required
expansionsarrayA comma separated list of fields to expand.
space.fieldsarrayA comma separated list of Space fields to display.
topic.fieldsarrayA comma separated list of Topic fields to display.
user.fieldsarrayA comma separated list of User fields to display.
user_idsarrayThe IDs of Users to search through.
spaces.search.listSearch spaces by keyword7 params
Search spaces by keyword
Parameters* required
expansionsarrayA comma separated list of fields to expand.
max_resultsintegerThe number of results to return.default: 100
querystringThe search query.
space.fieldsarrayA comma separated list of Space fields to display.
statestringThe state of Spaces to search for.one of
live · scheduled · alldefault: alltopic.fieldsarrayA comma separated list of Topic fields to display.
user.fieldsarrayA comma separated list of User fields to display.
spaces.getGet space details by ID5 params
Get space details by ID
Parameters* required
expansionsarrayA comma separated list of fields to expand.
idstringThe ID of the Space to be retrieved.
space.fieldsarrayA comma separated list of Space fields to display.
topic.fieldsarrayA comma separated list of Topic fields to display.
user.fieldsarrayA comma separated list of User fields to display.
spaces.buyers.listList users who purchased space tickets6 params
List users who purchased space tickets
Parameters* required
expansionsarrayA comma separated list of fields to expand.
idstringThe ID of the Space to be retrieved.
max_resultsintegerThe maximum number of results.default: 100
pagination_tokenstringThis parameter is used to get a specified 'page' of results.
tweet.fieldsarrayA comma separated list of Tweet fields to display.
user.fieldsarrayA comma separated list of User fields to display.
spaces.tweets.listGet posts shared in a space8 params
Get posts shared in a space
Parameters* required
expansionsarrayA comma separated list of fields to expand.
idstringThe ID of the Space to be retrieved.
max_resultsintegerThe number of Posts to fetch from the provided space. If not provided, the value will default to the maximum of 100.default: 100
media.fieldsarrayA comma separated list of Media fields to display.
place.fieldsarrayA comma separated list of Place fields to display.
poll.fieldsarrayA comma separated list of Poll fields to display.
tweet.fieldsarrayA comma separated list of Tweet fields to display.
user.fieldsarrayA comma separated list of User fields to display.
tweets.listGet posts by IDs7 params
Get posts by IDs
Parameters* required
expansionsarrayA comma separated list of fields to expand.
idsarrayA comma separated list of Post IDs. Up to 100 are allowed in a single request.
media.fieldsarrayA comma separated list of Media fields to display.
place.fieldsarrayA comma separated list of Place fields to display.
poll.fieldsarrayA comma separated list of Poll fields to display.
tweet.fieldsarrayA comma separated list of Tweet fields to display.
user.fieldsarrayA comma separated list of User fields to display.
tweets.createCreate or edit a post14 params
Create or edit a post
Parameters* required
card_uristringCard Uri Parameter. This is mutually exclusive from Quote Tweet Id, Poll, Media, and Direct Message Deep Link.
community_idstringThe unique identifier of this Community.
direct_message_deep_linkstringLink to take the conversation from the public timeline to a private Direct Message.
edit_optionsobjectOptions for editing an existing Post. When provided, this request will edit the specified Post instead of creating a new one.
for_super_followers_onlybooleanExclusive Tweet for super followers.default: false
geoobjectPlace ID being attached to the Tweet for geo location.
mediaobjectMedia information being attached to created Tweet. This is mutually exclusive from Quote Tweet Id, Poll, and Card URI.
nullcastbooleanNullcasted (promoted-only) Posts do not appear in the public timeline and are not served to followers.default: false
pollobjectPoll options for a Tweet with a poll. This is mutually exclusive from Media, Quote Tweet Id, and Card URI.
quote_tweet_idvaluereplyobjectTweet information of the Tweet being replied to.
reply_settingsstringSettings to indicate who can reply to the Tweet.one of
following · mentionedUsers · subscribers · verifiedshare_with_followersbooleanShare community post with followers too.default: false
textstringThe content of the Tweet.
tweets.analytics.listGet post engagement analytics5 params
Get post engagement analytics
Parameters* required
analytics.fieldsarrayA comma separated list of Analytics fields to display.
end_timestringYYYY-MM-DDTHH:mm:ssZ. The UTC timestamp representing the end of the time range.
granularitystringThe granularity for the search counts results.one of
hourly · daily · weekly · totaldefault: totalidsarrayA comma separated list of Post IDs. Up to 100 are allowed in a single request.
start_timestringYYYY-MM-DDTHH:mm:ssZ. The UTC timestamp representing the start of the time range.
tweets.search.recent.listSearch recent posts by query (last 7 days)15 params
Search recent posts by query (last 7 days)
Parameters* required
end_timestringYYYY-MM-DDTHH:mm:ssZ. The newest, most recent UTC timestamp to which the Posts will be provided. Timestamp is in second granularity and is exclusive (i.e. 12:00:01 excludes the first second of the...
expansionsarrayA comma separated list of fields to expand.
max_resultsintegerThe maximum number of search results to be returned by a request.default: 10
media.fieldsarrayA comma separated list of Media fields to display.
next_tokenstringThis parameter is used to get the next 'page' of results. The value used with the parameter is pulled directly from the response provided by the API, and should not be modified.
pagination_tokenstringThis parameter is used to get the next 'page' of results. The value used with the parameter is pulled directly from the response provided by the API, and should not be modified.
place.fieldsarrayA comma separated list of Place fields to display.
poll.fieldsarrayA comma separated list of Poll fields to display.
querystringOne query/rule/filter for matching Posts. Refer to https://t.co/rulelength to identify the max query length.
since_idstringReturns results with a Post ID greater than (that is, more recent than) the specified ID.
sort_orderstringThis order in which to return results.one of
recency · relevancystart_timestringYYYY-MM-DDTHH:mm:ssZ. The oldest UTC timestamp from which the Posts will be provided. Timestamp is in second granularity and is inclusive (i.e. 12:00:01 includes the first second of the minute).
tweet.fieldsarrayA comma separated list of Tweet fields to display.
until_idstringReturns results with a Post ID less than (that is, older than) the specified ID.
user.fieldsarrayA comma separated list of User fields to display.
tweets.getGet post details by ID7 params
Get post details by ID
Parameters* required
expansionsarrayA comma separated list of fields to expand.
idstringA single Post ID.
media.fieldsarrayA comma separated list of Media fields to display.
place.fieldsarrayA comma separated list of Place fields to display.
poll.fieldsarrayA comma separated list of Poll fields to display.
tweet.fieldsarrayA comma separated list of Tweet fields to display.
user.fieldsarrayA comma separated list of User fields to display.
tweets.deleteDelete post by ID1 params
Delete post by ID
Parameters* required
idstringThe ID of the Post to be deleted.
tweets.liking_users.listList users who liked a post6 params
List users who liked a post
Parameters* required
expansionsarrayA comma separated list of fields to expand.
idstringA single Post ID.
max_resultsintegerThe maximum number of results.default: 100
pagination_tokenstringThis parameter is used to get the next 'page' of results.
tweet.fieldsarrayA comma separated list of Tweet fields to display.
user.fieldsarrayA comma separated list of User fields to display.
tweets.quote_tweets.listList quote posts of a post10 params
List quote posts of a post
Parameters* required
excludearrayThe set of entities to exclude (e.g. 'replies' or 'retweets').
expansionsarrayA comma separated list of fields to expand.
idstringA single Post ID.
max_resultsintegerThe maximum number of results to be returned.default: 10
media.fieldsarrayA comma separated list of Media fields to display.
pagination_tokenstringThis parameter is used to get a specified 'page' of results.
place.fieldsarrayA comma separated list of Place fields to display.
poll.fieldsarrayA comma separated list of Poll fields to display.
tweet.fieldsarrayA comma separated list of Tweet fields to display.
user.fieldsarrayA comma separated list of User fields to display.
tweets.retweeted_by.getList users who reposted a post6 params
List users who reposted a post
Parameters* required
expansionsarrayA comma separated list of fields to expand.
idstringA single Post ID.
max_resultsintegerThe maximum number of results.default: 100
pagination_tokenstringThis parameter is used to get the next 'page' of results.
tweet.fieldsarrayA comma separated list of Tweet fields to display.
user.fieldsarrayA comma separated list of User fields to display.
tweets.retweets.listList reposts of a post9 params
List reposts of a post
Parameters* required
expansionsarrayA comma separated list of fields to expand.
idstringA single Post ID.
max_resultsintegerThe maximum number of results.default: 100
media.fieldsarrayA comma separated list of Media fields to display.
pagination_tokenstringThis parameter is used to get the next 'page' of results.
place.fieldsarrayA comma separated list of Place fields to display.
poll.fieldsarrayA comma separated list of Poll fields to display.
tweet.fieldsarrayA comma separated list of Tweet fields to display.
user.fieldsarrayA comma separated list of User fields to display.
tweets.hidden.updateHide or unhide reply to your post2 params
Hide or unhide reply to your post
Parameters* required
hiddenbooleantweet_idstringThe ID of the reply that you want to hide or unhide.
users.listGet users by IDs4 params
Get users by IDs
Parameters* required
expansionsarrayA comma separated list of fields to expand.
idsarrayA list of User IDs, comma-separated. You can specify up to 100 IDs.
tweet.fieldsarrayA comma separated list of Tweet fields to display.
user.fieldsarrayA comma separated list of User fields to display.
users.by.listGet users by usernames4 params
Get users by usernames
Parameters* required
expansionsarrayA comma separated list of fields to expand.
tweet.fieldsarrayA comma separated list of Tweet fields to display.
user.fieldsarrayA comma separated list of User fields to display.
usernamesarrayA list of usernames, comma-separated.
users.by.username.getGet user profile by username4 params
Get user profile by username
Parameters* required
expansionsarrayA comma separated list of fields to expand.
tweet.fieldsarrayA comma separated list of Tweet fields to display.
user.fieldsarrayA comma separated list of User fields to display.
usernamestringA username.
users.me.listGet authenticated user profile3 params
Get authenticated user profile
Parameters* required
expansionsarrayA comma separated list of fields to expand.
tweet.fieldsarrayA comma separated list of Tweet fields to display.
user.fieldsarrayA comma separated list of User fields to display.
users.personalized_trends.listGet personalized trending topics1 params
Get personalized trending topics
Parameters* required
personalized_trend.fieldsarrayA comma separated list of PersonalizedTrend fields to display.
users.reposts_of_me.listList reposts of authenticated user's posts8 params
List reposts of authenticated user's posts
Parameters* required
expansionsarrayA comma separated list of fields to expand.
max_resultsintegerThe maximum number of results.default: 100
media.fieldsarrayA comma separated list of Media fields to display.
pagination_tokenstringThis parameter is used to get the next 'page' of results.
place.fieldsarrayA comma separated list of Place fields to display.
poll.fieldsarrayA comma separated list of Poll fields to display.
tweet.fieldsarrayA comma separated list of Tweet fields to display.
user.fieldsarrayA comma separated list of User fields to display.
users.search.listSearch users by keyword6 params
Search users by keyword
Parameters* required
expansionsarrayA comma separated list of fields to expand.
max_resultsintegerThe maximum number of results.default: 100
next_tokenstringThis parameter is used to get the next 'page' of results. The value used with the parameter is pulled directly from the response provided by the API, and should not be modified.
querystringTThe the query string by which to query for users.
tweet.fieldsarrayA comma separated list of Tweet fields to display.
user.fieldsarrayA comma separated list of User fields to display.
users.getGet user profile by ID4 params
Get user profile by ID
Parameters* required
expansionsarrayA comma separated list of fields to expand.
idstringThe ID of the User to lookup.
tweet.fieldsarrayA comma separated list of Tweet fields to display.
user.fieldsarrayA comma separated list of User fields to display.
users.affiliates.listList affiliated accounts of a user6 params
List affiliated accounts of a user
Parameters* required
expansionsarrayA comma separated list of fields to expand.
idstringThe ID of the User to lookup.
max_resultsintegerThe maximum number of results.
pagination_tokenstringThis parameter is used to get a specified 'page' of results.
tweet.fieldsarrayA comma separated list of Tweet fields to display.
user.fieldsarrayA comma separated list of User fields to display.
users.blocking.listList users blocked by authenticated user6 params
List users blocked by authenticated user
Parameters* required
expansionsarrayA comma separated list of fields to expand.
idstringThe ID of the authenticated source User for whom to return results.
max_resultsintegerThe maximum number of results.
pagination_tokenstringThis parameter is used to get a specified 'page' of results.
tweet.fieldsarrayA comma separated list of Tweet fields to display.
user.fieldsarrayA comma separated list of User fields to display.
users.bookmarks.listList bookmarked posts9 params
List bookmarked posts
Parameters* required
expansionsarrayA comma separated list of fields to expand.
idstringThe ID of the authenticated source User for whom to return results.
max_resultsintegerThe maximum number of results.
media.fieldsarrayA comma separated list of Media fields to display.
pagination_tokenstringThis parameter is used to get the next 'page' of results.
place.fieldsarrayA comma separated list of Place fields to display.
poll.fieldsarrayA comma separated list of Poll fields to display.
tweet.fieldsarrayA comma separated list of Tweet fields to display.
user.fieldsarrayA comma separated list of User fields to display.
users.bookmarks.createBookmark a post2 params
Bookmark a post
Parameters* required
idstringThe ID of the authenticated source User for whom to add bookmarks.
tweet_idstringUnique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.
users.bookmarks.folders.listList bookmark folders3 params
List bookmark folders
Parameters* required
idstringThe ID of the authenticated source User for whom to return results.
max_resultsintegerThe maximum number of results.
pagination_tokenstringThis parameter is used to get the next 'page' of results.
users.bookmarks.folders.getList bookmarks in specific folder2 params
List bookmarks in specific folder
Parameters* required
folder_idstringThe ID of the Bookmark Folder that the authenticated User is trying to fetch Posts for.
idstringThe ID of the authenticated source User for whom to return results.
users.bookmarks.deleteRemove post from bookmarks2 params
Remove post from bookmarks
Parameters* required
idstringThe ID of the authenticated source User whose bookmark is to be removed.
tweet_idstringThe ID of the Post that the source User is removing from bookmarks.
users.dm.block.createBlock DMs from a user1 params
Block DMs from a user
Parameters* required
idstringThe ID of the target User that the authenticated user requesting to block dms for.
users.dm.unblock.createUnblock DMs from a user1 params
Unblock DMs from a user
Parameters* required
idstringThe ID of the target User that the authenticated user requesting to unblock dms for.
users.followed_lists.listList lists followed by user6 params
List lists followed by user
Parameters* required
expansionsarrayA comma separated list of fields to expand.
idstringThe ID of the User to lookup.
list.fieldsarrayA comma separated list of List fields to display.
max_resultsintegerThe maximum number of results.default: 100
pagination_tokenstringThis parameter is used to get a specified 'page' of results.
user.fieldsarrayA comma separated list of User fields to display.
users.followed_lists.createFollow a list2 params
Follow a list
Parameters* required
idstringThe ID of the authenticated source User that will follow the List.
list_idstringThe unique identifier of this List.
users.followed_lists.deleteUnfollow a list2 params
Unfollow a list
Parameters* required
idstringThe ID of the authenticated source User that will unfollow the List.
list_idstringThe ID of the List to unfollow.
users.followers.listList followers of a user6 params
List followers of a user
Parameters* required
expansionsarrayA comma separated list of fields to expand.
idstringThe ID of the User to lookup.
max_resultsintegerThe maximum number of results.
pagination_tokenstringThis parameter is used to get a specified 'page' of results.
tweet.fieldsarrayA comma separated list of Tweet fields to display.
user.fieldsarrayA comma separated list of User fields to display.
users.following.listList accounts a user follows6 params
List accounts a user follows
Parameters* required
expansionsarrayA comma separated list of fields to expand.
idstringThe ID of the User to lookup.
max_resultsintegerThe maximum number of results.
pagination_tokenstringThis parameter is used to get a specified 'page' of results.
tweet.fieldsarrayA comma separated list of Tweet fields to display.
user.fieldsarrayA comma separated list of User fields to display.
users.following.createFollow a user2 params
Follow a user
Parameters* required
idstringThe ID of the authenticated source User that is requesting to follow the target User.
target_user_idstringUnique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.
users.liked_tweets.listList posts liked by a user9 params
List posts liked by a user
Parameters* required
expansionsarrayA comma separated list of fields to expand.
idstringThe ID of the User to lookup.
max_resultsintegerThe maximum number of results.
media.fieldsarrayA comma separated list of Media fields to display.
pagination_tokenstringThis parameter is used to get the next 'page' of results.
place.fieldsarrayA comma separated list of Place fields to display.
poll.fieldsarrayA comma separated list of Poll fields to display.
tweet.fieldsarrayA comma separated list of Tweet fields to display.
user.fieldsarrayA comma separated list of User fields to display.
Featured
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Categories
Registryactive
TransportHTTP
AuthRequired
UpdatedMar 30, 2026
