Overview
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.
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. |
User Login POST
Log in to an X account with a username and password (plus a TOTP secret when two-factor authentication is enabled) and get back a fresh session: the auth_token, ct0, and twid cookies. This is a convenience alternative to Register Session for when you cannot copy cookies out of a browser. Bringing your own auth_token and ct0 via POST /customer/session stays the primary, recommended path. 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.