Skip to main content
GET
Advanced tweet search

Authorizations

x-api-key
string
header
required

Your ScrapeBadger API key. You can find this in your dashboard at https://scrapebadger.com/dashboard/api-keys.

Query Parameters

query
string
required

Search query string. Supports Twitter advanced search operators like from:, to:, since:, until:, min_faves:, min_retweets:, lang:, etc.

Example:

"from:elonmusk lang:en"

query_type
enum<string>
default:Top

Type of search results to return.

Available options:
Top,
Latest,
Media
count
integer
default:20

Number of tweets to return per page.

Required range: 1 <= x <= 100
cursor
string

Pagination cursor for fetching the next page of results.

Response

Successfully retrieved search results.

Paginated list of tweets.

data
object[] | null

Array of tweet objects.

next_cursor
string | null

Cursor for fetching the next page. Null if no more results.