Twitter Trends API | Worldwide and Per-Country
Trends: Read what is trending on Twitter/X right now, worldwide, for a single country, for one X Explore tab or for the trends X labels Business and finance, plus the full set of locations trends are available for.
Read what is trending on Twitter/X right now, worldwide, for a single country, for one X Explore tab or for the trends X labels Business and finance, plus the full set of locations trends are available for.
/trends reads either a location, worldwide or one of the specific locations X publishes trends for, or a category, never both in one call. Five categories are X Explore tabs (trending, news, sports, entertainment and for_you). The sixth, business_and_finance, is not a tab, because X serves none: it is a filter that reads the Trending and News tabs and keeps only the ranked trends X itself labels "Business and finance". Category results reflect the Explore view of the X account the API reads with, not your own account. /trends/locations is how you discover the valid locations, since X does not support arbitrary geography here. Call /trends/locations once (its result changes rarely) and cache the location ID your integration cares about, rather than re-resolving it on every /trends call.
This category has 2 endpoints. Each is a pay-per-call REST endpoint with bearer auth, JSON in and out.
| Method | Path | Cost | Description |
|---|---|---|---|
GET | /trends | $0.0008 | Read the current trending topics for a location, an Explore tab or a trend label. |
GET | /trends/locations | $0.0008 | List every location Twitter/X has trends available for. |
Trends
Read the current trending topics for a location, an Explore tab or a trend label.
Trend Locations
List every location Twitter/X has trends available for.
Session Status GET
Read the X session stored against your API key without changing it. Returns the account the session actually resolved to, whether it is still live or has been marked dead, when it was registered and last used, and which egress tier a write would leave on. It never returns auth_token, ct0, or any proxy URL. The key is taken from the authenticated request and the handler reads no identity from the body, the query string, or any second header, so a call can only ever read the caller's own session. This call is free. Cost: Free per call.
Trends GET
Fetch the current top trends for one location. Ask for it by country name, ISO code, or numeric WOEID; with no location parameter you get Worldwide. X returns roughly 50 trends per location, ranked. Pass category instead: trending, news, sports, entertainment or for_you reads that X Explore tab, and business_and_finance keeps only the ranked trends X labels Business and finance on its Trending and News tabs. Cost: $0.0008 per call.