Skip to main content
POST /v1/data/twitter/tweets/run Pricing: $0.00025 per tweet ($0.25 per 1,000). Search mode adds a flat $0.003 fee, charged even when nothing is found.

Ways to call it

  • Handle / Tweet URL: set inputs (optional: maxResults)
  • Search: set query (optional: maxResults)

Request

Send the inputs under params. Only the keys below are accepted; any other key returns 422 invalid_params.
string
A Twitter/X handle (e.g. ‘elonmusk’ for their timeline including retweets) or a single tweet URL to fetch.Format e.g. https://x.com/nasa/status/2039473910987534599.
integer
Maximum number of tweets to return. Use 0 for all.
string
Optional advanced-search query string (Twitter search operators supported, e.g. ‘from:nasa min_retweets:50 since:2026-01-01’).

Example

Response fields

Each row in data is one tweet, keyed by these fields.

Example response

Abridged: long text and lists are shortened.
For replies under one tweet use twitter/replies; for who retweeted use twitter/retweeters; for account data use twitter/profiles.