Search tweets by query, Tweet ID, X status URL, or account date window
Query parameters
Search query (keywords,
Sort order - Latest (chronological) or Top (engagement-ranked)
Pagination cursor from previous response
ISO 8601 timestamp - only return tweets after this time
ISO 8601 timestamp - only return tweets before this time
Max tweets to return (server paginates internally). Omit for single page (~20). This is an upper bound for paid authenticated calls: remaining credits can reduce the returned page size, and zero affordable results returns 402 insufficient_credits.
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.
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"
}