v1
latestOpenAPI 3.0.32026-07-213841124.9 KBSearch Tweets Advanced
Works the same way as Advanced Search in Twitter/X.
Searches for tweets that match a given text query. You pass a query parameter, and the endpoint returns up to 20 matching tweets per request. Each result includes the tweet text, creation date, engagement metrics, conversation details, and basic author information.
Results can be sorted by popularorlatest. If more results are available, a next_cursor is returned to load the next page.
The query syntax works the same way as Twitter/X Advanced Search. You can use operators like from:, to:, since:, until:, exact phrases, hashtags, and other filters to narrow down results if needed. For more examples of supported operators and query patterns, see: https://github.com/igorbrigadir/twitter-advanced-search
Use cases:
Analytics platforms tracking keywords and trends; marketing teams monitoring brand mentions or campaign phrases; research tools collecting filtered datasets (for example, tweets from a specific account during a date range); SaaS products building custom search dashboards; developers adding search functionality with cursor-based pagination.
Request body
Example request
{
"next_cursor": "JKHSJFHADUYJKSDy2y3u123",
"order": "popular",
"query": "elonmusk"
}Response
OK