Advanced Twitter Search API | Query Operators

Advanced Tweet Search runs a full-text query against Twitter/X using the same operator syntax as advanced search, including from:, to:, since:, min_faves:, and lang:. Results come back cursor-paginated at roughly 20 tweets per call for $0.0008, so a full sweep costs about $0.04 per 1,000 tweets.

curl -X GET "https://example.com/tweet/advanced_search?query=from%3Anaval+min_faves%3A1000&product=Latest&count=20"

{  "query": "from:naval min_faves:1000",  "product": "Latest",  "count": 20,  "next_cursor": "DAABCgABF...",  "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"      },      "favorite_count": 4821,      "retweet_count": 612,      "reply_count": 88,      "quote_count": 14,      "bookmark_count": 203,      "view_count": 219340    }  ]}

{  "error": "bad_request",  "message": "Missing or malformed parameter. Fix the request before retrying."}

{  "error": "unauthorized",  "message": "The API key is missing, malformed, or revoked. Check the Authorization header."}

{  "error": "insufficient_credits",  "message": "Your balance is exhausted. Top up your credits to continue."}

{  "error": "not_found",  "message": "The resource does not exist, for example a deleted tweet or a private account."}

{  "error": "rate_limited",  "message": "Too many requests. Back off and retry with exponential backoff."}

{  "error": "server_error",  "message": "Something failed on our side. Retry with backoff; if it persists, contact support."}

Pricing

Each page is one $0.0008 read, so a broad query spanning many pages adds up. Cap your page count and stop once you have enough rather than draining the full result set.

When to use

Use it to pull filtered tweet data by author, keyword, date, or engagement, for example every tweet from a competitor with over 1,000 likes this month.

Pagination

This endpoint is cursor-paginated and returns roughly 20 records per call. Pass the next_cursor from each response back as the cursor parameter to read the next page. Stop when the records array comes back empty: follower-graph endpoints return a non-null cursor even on the final page, so the empty array is the only reliable stop signal. See Pagination for the full loop.

Related endpoints

• User Search: Find users by keyword across display names, handles, and bios.
• User Mentions: Fetch tweets that mention a username.
• Tweet Detail: Fetch a single tweet's full object by ID.

FAQ

How many tweets does Advanced Tweet Search return per call?

About 20 tweets per call. Use cursor pagination to read past the first page; there is no page-size parameter to raise.

Which search operators are supported?

The same operators as Twitter/X advanced search, including from:, to:, since:, until:, min_faves:, min_retweets:, filter:, and lang:, all evaluated server-side.

How much does a tweet search cost?

It is $0.0008 per call for about 20 tweets, roughly $0.04 per 1,000 tweets. New accounts start with $0.50 in free credits.

Can I sort by latest or top?

Yes. Set the product parameter to Latest, Top, People, Photos, or Videos. It defaults to Latest.