Skip to Content

Search tweets by keyword

Search using X search syntax: `from:`, `lang:`, `-filter:replies`, `since_id:`, `min_faves:` and friends.

GET
/v1/tweets/search

Search using X search syntax: from:, lang:, -filter:replies, since_id:, min_faves: and friends.

Authorization

headerX-API-KEY<token>

Query Parameters

q*string

Search term, 1–512 characters

Range1 <= value <= 512
count?integer

1–100, default 20. X decides the real page size

Range1 <= value <= 100
Default"20"
category?string

Latest (default) or Top

Default"Latest"
Value in"Latest""Top"
cursor?string

The meta.cursor of the previous page

Rangevalue <= 2048
raw?string

Pass 1 or true to get the upstream's raw JSON instead of the flat payload (used for benchmark comparisons)

Response Body

OK

application/json
  1. response
data*array<>
meta?
Example Request
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"  }}