TwitterAPIs Docs
API ReferenceSearch

Advanced Tweet Search

Run a full-text tweet search using the same operator syntax as Twitter/X advanced search. Combine free text with operators such as from:, to:, since:, until:, min_faves:, and lang: to filter precisely. Results are cursor-paginated at roughly 20 tweets per call. Cost: $0.0008 per call.

GET
/tweet/advanced_search

Authorization

bearerAuth
AuthorizationBearer <token>

Pass your API key as a bearer token on every request: Authorization: Bearer <API_KEY>.

In: header

Query Parameters

query*string

Search query using Twitter operator syntax.

query_type?string

"Latest" or "Top". Defaults to "Latest".

cursor?string

Pagination cursor from a previous response's next_cursor.

Response Body

application/json

curl -X GET "https://example.com/tweet/advanced_search?query=from%3Anaval+min_faves%3A1000&query_type=Latest"
{  "tweets": [    {      "id": "1759123456789012345",      "text": "Reading > scrolling. Build the input, the output takes care of itself.",      "created_at": "Tue Feb 20 14:02:11 +0000 2026",      "author": {        "id": "745273",        "username": "naval",        "name": "Naval"      },      "like_count": 4821,      "retweet_count": 612,      "reply_count": 88,      "view_count": 219340    }  ],  "has_next_page": true,  "next_cursor": "DAABCgABF...",  "status": "success"}