Search tweets with minLikes, normalized likeCount, media & cursors
Tweets include authors, like counts, media, URLs & cursors. Omit mode for maximum coverage. Reuse next_cursor with unchanged filters.
Query parameters
Query, Tweet ID, or URL. Hyphens negate terms. Use exactPhrase for literals. Valid bounds apply per page.
Latest is chronological; Top ranks engagement. Aliases: result_type, sort_order.
Omit mode for resumable maximum coverage. Standard keeps legacy pagination. Coverage returns diagnostics once and rejects cursors.
Cursor from the previous response. Existing unprefixed cursors keep legacy standard behavior. Pages can be empty before more rows; follow next_cursor.
Inclusive ISO bound for Tweet creation time.
Exclusive ISO bound for Tweet creation time.
Unique matching result upper bound after filtering. Default 20. Explicit coverage defaults to 2000. It returns retained rows and deadline diagnostics when time expires. Only returned rows are billed. Credits may reduce results; zero affordable rows returns 402. Aliases: pageSize, count, max_results.
Filter by author username.
Filter replies sent to a username.
Filter tweets mentioning a username.
Filter by language. Alias lang is accepted.
Start date in YYYY-MM-DD format.
End date in YYYY-MM-DD format.
Filter media. Aliases: has_video, has_media.
Minimum likes. Aliases: minFaves, min_likes, min_faves.
Minimum retweets threshold.
Minimum replies threshold.
Minimum quote count threshold.
Minimum view count threshold.
Minimum bookmark count threshold.
Maximum likes threshold. maxLikes is also accepted.
Maximum retweets threshold.
Maximum replies threshold.
Maximum quotes threshold.
Only return tweets from Blue-verified authors.
Match the Tweet card name.
Match the source application.
Exclude a source application.
Match latitude, longitude, and radius.
Return Tweets whose IDs exceed this ID.
Return Tweets at or below this ID.
Match a place name.
Set the radius for the near filter.
Match Tweets from this recent window, such as 90m or 7d. Use a whole number and s, m, h, or d.
Only return native reposts.
Enable the safe-search filter.
X no longer searches filter:news.
Only return tweets from verified authors.
Reply mode. Exclude keeps own-thread replies.
Only when the caller requests a repost mode.
Only when the caller requests a quote mode.
Match this literal phrase, including any hyphens.
Words or quoted phrases to exclude. Separate with spaces, commas, or lines.
Words or quoted phrases where any one can match. Separate with spaces, commas, or lines.
Hashtags separated by spaces, commas, or lines.
Cashtags separated by spaces, commas, or lines.
URL substring or domain filter.
Conversation ID filter.
Only replies to this tweet ID.
Only quotes of this tweet ID.
Only retweets of this tweet ID.
Search within a list ID.
Search within a place ID.
Search within a country code.
Geo point radius, e.g. -73.99 40.73 25mi.
Geo bounding box, e.g. -74.1 40.6 -73.9 40.8.
Raw advanced search query appended as-is.
Response
Search results
Example response
{
"tweets": [],
"has_next_page": false,
"next_cursor": ""
}