/tweet/advanced_search$0.0008 / callAdvanced 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.
- →Use cursor pagination to read past the first ~20 results; do not increase page size.
- →Operators are evaluated server-side exactly as on twitter.com/search-advanced.
Request
curl "https://api.twitterapis.com/tweet/advanced_search?query=from%3Anaval%20min_faves%3A1000&query_type=Latest" \
-H "Authorization: Bearer $TWITTERAPIS_KEY"Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | required | Search query using Twitter operator syntax. Example: |
query_type | string | optional | "Latest" or "Top". Defaults to "Latest". Example: |
cursor | string | optional | Pagination cursor from a previous response's next_cursor. |
Response
| Field | Type | Description |
|---|---|---|
tweets | array<Tweet> | Matching tweets for this page. |
has_next_page | boolean | True when more results are available; pass next_cursor to fetch them. |
next_cursor | string | Opaque cursor token for the next page. Empty string on the final page. |
status | string | Request status, "success" on a normal response. |
Example response
{
"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"
}Pricing for this endpoint
tweet/advanced_search costs $0.0008 per call and returns ~20 tweets, so roughly $0.04 per 1,000 tweets. No subscriptions or minimum spend.