Skip to main content
GET
Search X posts

Authorizations

Authorization
string
header
required

API key in the format: Bearer {api_token}

Query Parameters

query
string
required

X search query, max 512 characters.

account_id
string

Connected X account to act as (sacct_ prefix id). Optional: a platform connects once per account, so the X account is resolved automatically.

limit
integer

Results per page, 10-100. X rejects anything below 10.

Required range: 10 <= x <= 100
since_id
string

Only posts newer than this numeric post id — the cursor for a polling loop.

until_id
string

Only posts older than this numeric post id.

start_time
string

Oldest UTC timestamp, inclusive (ISO 8601). Within the last 7 days.

end_time
string

Newest UTC timestamp, exclusive (ISO 8601). Within the last 7 days.

cursor
string

Opaque pagination cursor from a previous response's next_cursor.

sort_order
enum<string>

recency (default) or relevancy.

Available options:
recency,
relevancy

Response

Matching X posts

object
enum<string>
required
Available options:
list
data
object[]
required
has_more
boolean
required
next_cursor
string
url
string