Skip to main content
POST /v1/data/twitter/trends/run Pricing: $0.001 per trend ($1.00 per 1,000).

Request

Send the inputs under params. Only the keys below are accepted; any other key returns 422 invalid_params.
string[]
default:"[\"Worldwide\"]"
Where to read trends. Pick Worldwide, any of the 62 countries X reports trends for, or a major city; one request reads them all. Defaults to Worldwide. Through the API any other place X tracks also works: a two-letter country code (US), another city name, or a WOEID (23424977).123 allowed values, for example Worldwide, Algeria, Argentina, Australia, Austria, Bahrain, Belarus, Belgium, Brazil, Canada. Fetch the full list with GET /v1/data/twitter/trends?expand=options.
integer
default:"50"
How many trends to return in total. Defaults to 50; use 0 for all.

Example

Response fields

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

Example response

Abridged: long text and lists are shortened.
For tweets on a trend use twitter/tweets.