Trends
List trends
Get ranked X trends by region with WOEID filtering
GET
List trends
Direct trends handoff
UseGET /trends when a dashboard, alerting job, content queue, warehouse, or
agent needs ranked X topics for a supported WOEID region.
The Node.js, Python, and Go examples shape one JSON line per trend. Store
trend_name, rank, description, search_query, region_woeid,
requested_count, and returned_total. Pass search_query to
Search Tweets when the next step needs
matching tweets.
total is the number of valid trends available before count slicing. Use it
to detect whether a smaller count hid extra rows.
Headers
Full account key. Sessions and OAuth also work.
Bearer xq_your_guest_key_here authenticates paid_reads guest keys. Direct MPP uses the Payment ... credential. Get it from the WWW-Authenticate: Payment challenge.Query parameters
Region WOEID. See supported regions below. Default:
1 (Worldwide).Number of trends to return. Max
50, default 30.Response
- 200 OK
- 400 Invalid Input
- 401 Unauthenticated
- 402 Payment required
- 429 Rate Limit Exceeded
- 424 Dependency Failed
Regions
Use these WOEIDs in thewoeid query parameter. Omit woeid or pass 1 for
worldwide trends.
Global & Americas
1- Worldwide23424977- United States23424775- Canada23424900- Mexico23424768- Brazil
Europe
23424975- United Kingdom23424969- Turkey23424950- Spain23424829- Germany23424819- France
Asia
23424856- Japan23424848- India
Related: Billing & Usage · Search Tweets
Last modified on July 13, 2026
List trends