🇺🇸English
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) |
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_tweets with query like "$SOL min_faves:50" — find popular tweetstwitter_search_users with the topic — find relevant accounts- Follow up with
twitter_user_info on 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_users with keyword (e.g. "DeFi analyst")twitter_user_info on top results to compare follower countstwitter_user_tweets to 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 |
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_KEY environment 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.
Weekly Installs
3.1K
Repository
starchild-ai-ag…l-skills
GitHub Stars
1
First Seen
12 days ago
Security Audits
Gen Agent Trust HubPassSocketPassSnykWarn
Installed on
openclaw3.1K
opencode39
gemini-cli39
github-copilot39
codex39
amp39
