Skip to main content
GET
Search X (Twitter) feed

Authorizations

X-API-Key
string
header
required

API Key authentication. Example: "your-api-key-here"

Query Parameters

q
string

Search query (BM25 over full_text; #tag and @user route to filter clauses). Omit for reverse-chronological listing.

handle
string

Restrict to tweets authored by this Twitter handle (no @, case-insensitive)

since
integer

Start time (unix seconds)

until
integer

End time (unix seconds)

content_type
enum<string>[]

Filter by content type

Available options:
original,
retweet,
quote,
reply
has_media
boolean

Only return tweets with media when true

limit
integer

Max results (default 50, max 200)

offset
integer

Offset

sort
enum<string>

Result ordering: relevance (default, BM25), latest (reverse-chronological), or hottest (by view_count)

Available options:
relevance,
latest,
hottest

Response

Tweet list

data
object[]
error
object
metadata
any
pagination
any
request_id
string
success
boolean