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 underparams. Only the keys below are accepted; any other key returns 422 invalid_params.
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.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 indata is one tweet, keyed by these fields.
Example response
Abridged: long text and lists are shortened.Related APIs
For replies under one tweet usetwitter/replies; for who retweeted use twitter/retweeters; for account data use twitter/profiles.