Search
search_tweetsX advanced search. q takes the x.com operators. 1 credit per tweet or profile. product Latest is always available; Top may answer 403 (free).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"q": "<q>"
},
"name": "search_tweets"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | Yes | Query with x.com operators, e.g. "from:x since:2026-09-01 -filter:replies" | |
| count | No | Page size, 1 to 50. Default 20. | |
| fresh | No | Read X again and skip the cache. Costs 2x credits for an item that has a cached copy, the normal price for one that has none. | |
| cursor | No | next_cursor from the previous page | |
| product | No | Default Latest. People returns profiles. |