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.
Unsupported or malformed woeid. Use one of the WOEIDs in the regions table. count is clamped between 1 and 50; nonnumeric values fall back to 30.
{ "error": "unauthenticated" }
Missing or invalid API key. Check the x-api-key header value.
{ "error": "no_subscription" }
No active subscription or insufficient credits. Possible error values: no_subscription, subscription_inactive, no_credits, insufficient_credits.
For MPP requests without a valid payment credential, 402 returns a WWW-Authenticate: Payment challenge header instead.
{ "error": "x_api_unavailable" }
The read service is temporarily unavailable. Retry with exponential backoff.