Skip to main content
GET
Advanced tweet search

Choosing query_type

Use Latest when you need a fresh, chronological feed (e.g. monitoring), and Top when you want maximum coverage of relevant tweets for a query.

Pagination

Paginate with the cursor parameter. Each response includes a top-level next_cursor — pass it back as cursor to fetch the next page.
Python
The response has no meta field. Pagination state lives in the top-level next_cursor — don’t read data["meta"].

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.