Twitter Trends Locations API
List every place X (Twitter) publishes trends for, with WOEIDs. $0.01 per call.
Get the full list of locations X (Twitter) has trending topics for: around 467 countries and cities, each with its WOEID, name, country, country code, and place type. Use the WOEIDs with the Twitter Trends API.
Try it live
Fill in the fields and hit Run to see a real response.
{
"ok": true,
"data": {
"locations": [
{
"country": null,
"country_code": null,
"name": "Worldwide",
"type": "Supername",
"woeid": 1
}
]
}
}Features
Around 467 locations: worldwide, countries, and cities.
Each location includes the woeid to pass to the Twitter Trends API.
name, country, country_code, and type (Supername, Country, or Town).
Send an empty JSON body {}.
The list rarely changes and is cached for a day.
Use cases
Location Pickers
Populate a country or city selector for a trends tool.
Coverage Checks
See which cities have their own trend lists.
Batch Trend Jobs
Loop over every country's WOEID to collect trends.
Quick start
Copy this snippet and start making calls.
const res = await fetch('https://api.yepapi.com/v1/twitter/trends-locations', {
method: 'POST',
headers: {
'x-api-key': 'YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({}),
});
const data = await res.json();
console.log(data);The Twitter Trends Locations API for WOEIDs
The YepAPI Twitter Trends Locations API lists every place X publishes trending topics for. Call /v1/twitter/trends-locations with an empty body and get around 467 locations with their WOEID, name, country, country code, and type, at $0.01 per call.
Call it once, cache the result, and use the WOEIDs with the Twitter Trends API.
What does the Twitter Trends Locations API return?
A locations array. Each location has woeid, name, country, country_code, and type. Worldwide is woeid 1 with type Supername; countries and towns follow.
Build a location picker
Fetch the list once, group it by country, and render a picker for your trends tool. When a user picks a place, pass its woeid to /v1/twitter/trends.
Twitter Trends Locations API pricing: $0.01 per call
Every call costs a flat $0.01 and failed calls are free. There is no monthly tier to buy, no developer account to get approved, and no separate Twitter API key: one YepAPI key covers every endpoint. The list is cached for 24 hours, so one call a day is plenty.
What is a WOEID?
A WOEID (Where On Earth ID) is a numeric place identifier. X uses them to key its trend lists, so every trends request needs one. This endpoint is the source of truth for which WOEIDs X supports.
Try the Twitter Trends Locations API free
Sign up and get $5 in free credit with no card required. That is 500 calls at $0.01 each to test the Twitter Trends Locations API on live X data before you spend anything. The Twitter Trends API is on the same key.
Start making API calls in 30 seconds
$5 free credit on signup. No credit card required. Pay per call.
What developers say
“Switched from SerpAPI and cut our SERP costs by 80%. Same data quality, way simpler billing.”
“One API key for AI models, SERP data, and web scraping. Saved us from managing 4 separate providers.”
“The $5 free credit let us prototype our entire rank tracking feature before committing. No other API does that.”
Frequently asked questions
Get the full list of locations X (Twitter) has trending topics for: around 467 countries and cities, each with its WOEID, name, country, country code, and place type. Use the WOEIDs with the Twitter Trends API.
Each API call costs $0.01. No monthly minimums or subscriptions — you only pay for what you use.
Sign up for a free API key, then send a POST request to /v1/twitter/trends-locations. Check the code example above for a ready-to-use snippet in JavaScript, cURL, or Python.
YepAPI bundles SEO, AI, and web scraping APIs under one key with no monthly minimums. You get lower per-call pricing, a unified dashboard, and one billing account instead of managing multiple providers.
Ready to integrate?
Get your API key and start making calls in 30 seconds. $5 free credit on signup — no credit card required.
More Twitter / X API endpoints
Twitter Trends API
$0.01Get X (Twitter) trending topics worldwide or for any country or city by WOEID. $0.01 per call.
Twitter Search API (X Search API)
$0.01Search tweets or people on X with full search operators. Top, latest, people, or media results. $0.01 per call.
Twitter User API (X Profile API)
$0.01Get any X (Twitter) profile by username: followers, following, tweets, bio, and verification. $0.01 per call.
X About This Account API
$0.01Get X's "About this account" data: country, username changes, verified-since date, and affiliation. $0.01 per call.
Twitter Bulk Users API
$0.01Look up to 100 X (Twitter) profiles by user id in a single call. $0.01 per call.
Tweet Scraper API (User Tweets)
$0.01Get the latest tweets from any X (Twitter) account with full engagement metrics. A tweet scraper at $0.01 per call.