find_tools, describe_tool, execute_tool — with
several providers behind the scenes, so one route failing does not stop the
task.
What you can ask
- “What are people saying about AgentKey on X today?”
- “Pull the last 20 posts from @NASA and summarize the themes.”
- “Show me the replies and quote tweets on this post, with the overall sentiment.”
- “Who follows this account, and which of them are verified?”
- “Which accounts gained the most followers in the past week among these ten?”
- “What is trending on X in Japan right now?”
- “Is this account shadowbanned?”
- “List the members of this X community and what they have been posting.”
What’s covered
Posts- Keyword search with X’s operators —
from:,to:,since:/until:, exact phrases, hashtags, media filters - Post detail by ID or URL, in single and batch form
- Replies and comments, quote posts, the list of reposters
- Long-form articles, a user’s media posts, a user’s latest replies
- Profile by handle or ID, single or batch; the “about” page; affiliates
- Followers and following, verified followers, follower category breakdowns
- New followers and new following over the last seven days
- Handle ↔ ID conversion, profile link → ID, live-status and shadowban checks
- List posts, list members, list followers
- Community info, members and timeline; community search; keyword search inside a community; membership checks
- Trending topics, by country
- Spaces information
- Does A follow B, did A repost or quote this post
- Follower-quality scores and their changes over time, top followers and top following by score
How to use it
Pass the request in plain language and let the router pick the tool:describe_tool before executing — parameters and
per-call costs differ between providers.
Building with code? The same capability is available as fixed-contract
Scenario Methods with automatic provider
failover:
social.x.post.search,
social.x.post.get,
social.x.post.comments,
social.x.user.get,
social.x.user.posts,
social.x.user.search,
social.x.trending.FAQ
Do I need an X developer account or API key?
Do I need an X developer account or API key?
No. AgentKey holds the upstream access; your agent only needs your AgentKey
subscription.
Can it read protected accounts or direct messages?
Can it read protected accounts or direct messages?
No. Only public posts, profiles and relationships are available.
How fresh is the data?
How fresh is the data?
Every call goes to the platform at request time; nothing is served from a
stale archive. Trend and search results reflect what X returns at that
moment.