Twitter / X Data
Read-only access to Twitter/X via twitterapi.io. Use these tools to look up tweets, users, followers, and social activity.
Tool Decision Tree
"Search for tweets about a topic" → twitter_search_tweets
Advanced query with operators: keywords, from:user, #hashtag, $cashtag, min_faves, date ranges.
"Look up a specific tweet or set of tweets" → twitter_get_tweets
Pass one or more tweet IDs directly.
"Who is this Twitter account?" → twitter_user_info
Profile data: bio, follower count, tweet count, verification.
"What has this account been posting?" → twitter_user_tweets
Recent tweets from a specific user.
"Who follows this account?" → twitter_user_followers
List of followers for a user.
"Who does this account follow?" → twitter_user_followings
List of accounts a user follows.
"What are people saying in reply to this tweet?" → twitter_tweet_replies
Replies to a specific tweet by ID.
"Who retweeted this?" → twitter_tweet_retweeters
Users who retweeted a specific tweet.
"Find accounts related to a topic" → twitter_search_users
Search users by name or keyword.
Available Tools
| Tool | Description | Key Params |
|---|---|---|
twitter_search_tweets | Advanced tweet search | query (required), cursor |
twitter_get_tweets | Get tweets by ID | tweet_ids (array, required) |
twitter_user_info | User profile lookup | username (required) |
twitter_user_tweets | User's recent tweets | username (required), cursor |
twitter_user_followers | User's followers | username (required), cursor |
twitter_user_followings | User's followings | username (required), cursor |
twitter_tweet_replies | Replies to a tweet | tweet_id (required), cursor |
twitter_tweet_retweeters | Who retweeted | tweet_id (required), cursor |
twitter_search_users | Search for users | query (required), cursor |
Usage Patterns
Research an account
twitter_user_info— get profile, follower count, biotwitter_user_tweets— see what they've been postingtwitter_user_followings— who they follow (reveals interests)
Track a topic or token
twitter_search_tweetswith query like"$SOL min_faves:50"— find popular tweetstwitter_search_userswith the topic — find relevant accounts- Follow up with
twitter_user_infoon interesting accounts
Analyze engagement on a tweet
twitter_get_tweets— get the tweet and its metricstwitter_tweet_replies— see the conversationtwitter_tweet_retweeters— see who amplified it
Find influencers in a space
twitter_search_userswith keyword (e.g. "DeFi analyst")twitter_user_infoon top results to compare follower countstwitter_user_tweetsto check content quality
Search Query Operators
The twitter_search_tweets tool supports advanced operators:
| Operator | Example | Description |
|---|---|---|
| keyword | bitcoin | Tweets containing the word |
| exact phrase | "ethereum merge" | Exact phrase match |
from: | from:elonmusk | Tweets by a specific user |
to: | to:elonmusk | Tweets replying to a user |
#hashtag | #crypto | Tweets with hashtag |
$cashtag | $BTC | Tweets with cashtag |
lang: | lang:en | Filter by language |
has:media | has:media | Tweets with images/video |
has:links | has:links | Tweets with URLs |
is:reply | is:reply | Only replies |
min_faves: | min_faves:100 | Minimum likes |
min_retweets: | min_retweets:50 | Minimum retweets |
since: | since:2024-01-01 | Tweets after date |
until: | until:2024-12-31 | Tweets before date |
Combine operators: from:VitalikButerin $ETH min_faves:100 since:2024-01-01
Pagination
Most endpoints support cursor-based pagination. When a response includes a cursor value, pass it as the cursor parameter to get the next page. If no cursor is returned, you've reached the end.
Notes
- API key required: Set
TWITTER_API_KEYenvironment variable. Tools will error without it. - Read-only: These tools only retrieve data. No posting, liking, or following.
- Usernames: Always pass without the
@prefix (e.g."elonmusk"not"@elonmusk"). - Tweet IDs: Use string format for tweet IDs to avoid integer overflow issues.
- Rate limits: The API has rate limits. If you get rate-limited, wait before retrying.