Search tweets
search_tweetsSearch X posts and accounts using X search operators like from:, lang:, since:, and min_faves:, with pagination and category tabs for Top, Latest, People, Photos, and Videos.
Instructions
Search X like the search box. Supports X search operators in the query, e.g. from:user, to:user, "exact phrase", lang:en, since:2025-01-01, until:2025-02-01, min_faves:100, filter:media, -filter:replies. category Latest gives newest first; People returns accounts instead of tweets. Paginated.
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": {
"searchItem": "<searchItem>"
},
"name": "search_tweets"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | No | How many results to request per page (default 20). X may return slightly more or fewer. | |
| cursor | No | Pagination cursor. Leave empty for the first page; pass the next_cursor from a previous result to get the next page. | |
| format | No | Response format (default simple). simple: compact JSON with flat camelCase tweets and users, about 60% fewer tokens. raw: X's full GraphQL JSON, only needed for fields simple leaves out (cards, polls, edit history, community notes). | |
| category | No | Result tab: Top (default), Latest, People, Photos or Videos. | |
| max_chars | No | Maximum characters of JSON to return (default 50000). Longer output is cut with a [TRUNCATED] marker. Lower it to save context, raise it if you need the full response. | |
| searchItem | Yes | Search query, max 512 characters. May contain X search operators. |