Skip to main content
GET
List trends
3 credits per call · All plans from $0.00012/credit · Direct MPP: USD 0.00045 per call
Use GET /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

x-api-key
string
Full account key. Sessions and OAuth also work.
Authorization
string
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

woeid
number
Region WOEID. See supported regions below. Default: 1 (Worldwide).
count
number
Number of trends to return. Max 50, default 30.

Response

Array of trending topics.
total
number
Full count of available trends before slicing by count.
woeid
number
Region WOEID used for this request.

Regions

Use these WOEIDs in the woeid query parameter. Omit woeid or pass 1 for worldwide trends.

Global & Americas

  • 1 - Worldwide
  • 23424977 - United States
  • 23424775 - Canada
  • 23424900 - Mexico
  • 23424768 - Brazil

Europe

  • 23424975 - United Kingdom
  • 23424969 - Turkey
  • 23424950 - Spain
  • 23424829 - Germany
  • 23424819 - France

Asia

  • 23424856 - Japan
  • 23424848 - India
Last modified on July 13, 2026