Loading...
Loading...
Twitter/X research via paid API: search tweets with 50+ operators, fetch tweets with threads/replies/quotes, get user profiles with tweets/followers/following. Uses x_payment tool for automatic USDC micropayments ($0.003/call). Use when: (1) searching tweets by keyword, user, or advanced operators, (2) fetching specific tweets by ID/URL with context, (3) looking up user profiles and their activity.
npx skill4agent add cascade-protocol/agentbox agentbox-twitterhttps://twitter.x402.agentbox.fyix_paymentx_payment({
"url": "https://twitter.x402.agentbox.fyi/search",
"method": "GET",
"params": "{\"q\": \"from:elonmusk AI\", \"type\": \"Latest\", \"limit\": 20}"
})| Param | Type | Default | Description |
|---|---|---|---|
| q | string | required | Search query with operators |
| type | "Latest" or "Top" | Latest | Sort by recency or popularity |
| limit | 1-200 | 20 | Max tweets to return |
| cursor | string | - | Pagination cursor from previous response |
| Operator | Example | Description |
|---|---|---|
| from:user | | Tweets by user |
| to:user | | Replies to user |
| @user | | Mentioning user |
| min_faves:N | | Minimum likes |
| min_retweets:N | | Minimum retweets |
| min_replies:N | | Minimum replies |
| filter:media | | Has media |
| filter:images | | Has images |
| filter:videos | | Has video |
| filter:links | | Has links |
| filter:replies | | Only replies |
| -filter:replies | | Exclude replies |
| since:date | | After date |
| until:date | | Before date |
| within_time:Nh | | Last N hours |
| lang:code | | Language filter |
| conversation_id:ID | | In conversation |
| filter:self_threads | | User's thread replies |
from:elonmusk AI min_faves:100 -filter:replies within_time:7d{ query, tweets[], count, hasMore, nextCursor, summary }summarytotalLikestotalRetweetstotalRepliesavgLikesmaxLikestopTweetIdx_payment({
"url": "https://twitter.x402.agentbox.fyi/tweet/1585841080431321088",
"method": "GET",
"params": "{\"include\": \"thread,replies\", \"limit\": 50}"
})/tweet/{ref}1585841080431321088123,456,789| Param | Type | Default | Description |
|---|---|---|---|
| include | string | - | Comma-separated: |
| limit | 1-200 | 50 | Max replies/quotes to return |
threadrepliesquotes{ tweets[], count, parent?, thread?, replies?, quotes? }parentx_payment({
"url": "https://twitter.x402.agentbox.fyi/user/elonmusk",
"method": "GET",
"params": "{\"include\": \"tweets\", \"limit\": 20}"
})/user/{ref}elonmusk@elonmusk44196397123,456| Param | Type | Default | Description |
|---|---|---|---|
| include | string | - | Comma-separated: |
| limit | 1-200 | 50 | Max tweets/followers/following to return |
| include_replies | boolean | false | Include replies in user's tweets |
{ user, tweets?, followers?, following? }{ users[], count, hasMore }x_payment({
"url": "https://twitter.x402.agentbox.fyi/search",
"method": "GET",
"params": "{\"q\": \"x402 OR \\\"402 payment\\\" min_faves:5 within_time:24h\", \"type\": \"Latest\"}"
})x_payment({
"url": "https://twitter.x402.agentbox.fyi/tweet/1585841080431321088",
"method": "GET",
"params": "{\"include\": \"thread,replies,quotes\", \"limit\": 20}"
})x_payment({
"url": "https://twitter.x402.agentbox.fyi/user/CoinbaseDev",
"method": "GET",
"params": "{\"include\": \"tweets\", \"limit\": 50}"
})nextCursorx_payment({
"url": "https://twitter.x402.agentbox.fyi/search",
"method": "GET",
"params": "{\"q\": \"from:elonmusk\", \"cursor\": \"DAABCgAB...\"}"
})| HTTP | Meaning |
|---|---|
| 400 | Invalid parameters (check query syntax) |
| 402 | Payment required (handled automatically by x_payment) |
| 404 | Tweet or user not found |
| 502 | Upstream API error |