Search tweets by keyword
Search using X search syntax: `from:`, `lang:`, `-filter:replies`, `since_id:`, `min_faves:` and friends.
GET
Search using X search syntax: from:, lang:, -filter:replies, since_id:, min_faves: and friends.
header
X-API-KEY<token>q*stringSearch term, 1–512 characters
Range
1 <= value <= 512count?integer1–100, default 20. X decides the real page size
Range
1 <= value <= 100Default
"20"category?stringLatest (default) or Top
Default
"Latest"Value in
"Latest""Top"cursor?stringThe meta.cursor of the previous page
Range
value <= 2048raw?stringPass 1 or true to get the upstream's raw JSON instead of the flat payload (used for benchmark comparisons)
OK
application/json- response
data*array<>meta?curl -X GET 'https://api.agenttweet.com/v1/tweets/search?q=string'Example Response
{ "data": [ { "id": "string", "text": "string", "author": "string", "created_at": "string", "is_retweet": true, "author_id": "string", "author_name": "string", "likes": 0, "retweets": 0, "replies": 0, "quotes": 0, "views": 0, "media": null, "hashtags": null, "mentions": null, "urls": null, "lang": "string", "is_reply": true, "is_quote": true, "quoted_tweet_id": "string", "conversation_id": "string", "in_reply_to": "string" } ], "meta": { "count": 0, "cursor": "string", "provider": "string", "cached": true, "tokens_raw": 0, "tokens_flat": 0, "tokens_saved": 0, "tokens_saved_pct": 0, "tokens_billed": 0, "cost_usd": 0, "balance_usd": 0, "request_id": "string" }}