v
latestOpenAPI 3.1.02026-08-09127104507.8 KBSearch tweets by query, Tweet ID, X status URL, or account date window
No-mode search maximizes coverage.
Query parameters
Query, Tweet ID, or status URL. Valid inline bounds apply per page.
Sort order - Latest (chronological) or Top (engagement-ranked)
Omit mode for resumable maximum coverage. Standard keeps legacy pagination. Coverage returns diagnostics once and rejects cursors.
Cursor from the previous response. Xquik cursors resume automatic coverage. Existing unprefixed cursors keep legacy standard behavior.
Inclusive ISO bound.
Exclusive ISO bound.
Result upper bound. Omit it for the existing 20-row page size. Explicit coverage defaults to 2000 and allows 10000. For paid requests, remaining credits can reduce results. Zero affordable results returns 402.
Filter by author username.
Filter replies sent to a username.
Filter tweets mentioning a username.
Language code filter, e.g. en or tr.
Start date in YYYY-MM-DD format.
End date in YYYY-MM-DD format.
Filter by media type.
Minimum likes threshold.
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 newer than this Tweet ID.
Return Tweets older than this Tweet ID.
Match a place name.
Set the radius for the near filter.
Match Tweets inside a recent time window.
Only return native reposts.
Enable the safe-search filter.
Only return news results.
Only return tweets from verified authors.
Reply mode.
Retweet mode.
Quote mode.
Exact phrase to match.
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": [
{
"id": "1234567890",
"text": "Just launched our new feature!",
"retweetCount": 5,
"replyCount": 3,
"likeCount": 42,
"quoteCount": 1,
"viewCount": 1500,
"bookmarkCount": 2
}
],
"has_next_page": true,
"next_cursor": "DAACCgACGRElMJcAAA"
}