Twitter Trends API
Get X (Twitter) trending topics worldwide or for any country or city by WOEID. $0.01 per call.
Get the current trending topics on X (Twitter) for a location. Pass a WOEID (1 for worldwide, 23424977 for the United States, or any id from the Trends Locations API) and get each trend's name, search query, X search URL, and tweet volume where X provides it.
Try it live
Fill in the fields and hit Run to see a real response.
{
"ok": true,
"data": {
"as_of": "2026-10-31T01:10:52Z",
"location": {
"name": "Worldwide",
"woeid": 1
},
"trends": [
{
"name": "ハッピーハロウィン",
"query": "ハッピーハロウィン",
"tweet_volume": null,
"url": "https://x.com/search?q=%E3%83%8F%E3%83%83%E3%83%94%E3%83%BC%E3%83%8F%E3%83%AD%E3%82%A6%E3%82%A3%E3%83%B3"
}
]
}
}Features
woeid 1 is worldwide; use the Trends Locations API to find ids for around 467 countries and cities.
Each trend includes the exact query and an x.com search URL.
tweet_volume is included when X reports it (null otherwise).
as_of tells you when the trend list was captured.
Trend lists are cached for 10 minutes.
Use cases
Newsrooms
Spot breaking topics per country as they start trending.
Content Planning
Tie posts and campaigns to what is trending now.
Trend Archives
Record trends over time for research.
Quick start
Copy this snippet and start making calls.
const res = await fetch('https://api.yepapi.com/v1/twitter/trends', {
method: 'POST',
headers: {
'x-api-key': 'YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({
"woeid": 1
}),
});
const data = await res.json();
console.log(data);The Twitter Trends API for trending topics on X
The YepAPI Twitter Trends API returns what is trending on X right now for any supported place. Send a WOEID to /v1/twitter/trends and get each trend's name, search query, x.com search URL, and tweet volume, at $0.01 per call.
Use woeid 1 for worldwide trends, a country id for national trends, or a city id for local ones.
What does the Twitter Trends API return?
A location object ({ name, woeid }), an as_of timestamp, and a trends array where each trend has name, query, url, and tweet_volume (null when X does not publish a volume).
Build a trends dashboard
Poll /v1/twitter/trends every 10 minutes for the places you care about and store each list with its as_of time. Click through any trend with the Twitter Search API (pass the trend's query) to see the tweets behind it, and compare with the Reddit Popular Posts API on the same key.
Twitter Trends 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. Trend lists are cached for 10 minutes, matching how often they meaningfully change.
Finding WOEIDs
WOEIDs (Where On Earth IDs) identify places. 1 is worldwide and 23424977 is the United States. Call the Trends Locations API once to get the full list of about 467 supported countries and cities with their ids.
Try the Twitter Trends 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 API on live X data before you spend anything. Search and the rest of the Twitter / X API are 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 current trending topics on X (Twitter) for a location. Pass a WOEID (1 for worldwide, 23424977 for the United States, or any id from the Trends Locations API) and get each trend's name, search query, X search URL, and tweet volume where X provides it.
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. 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 Locations API
$0.01List every place X (Twitter) publishes trends for, with WOEIDs. $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.