Twitter Trends API | Worldwide and Per-Country
Trends: Read what is trending on Twitter/X right now, worldwide or for a single country, plus the full set of locations trends are available for.
Read what is trending on Twitter/X right now, worldwide or for a single country, plus the full set of locations trends are available for.
/trends needs a location, either worldwide or one of the specific locations X publishes trends for; /trends/locations is how you discover what those valid locations actually are, 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. |
GET | /trends/locations | $0.0008 | 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. Cost: $0.0008 per call.