Trending topics on X (Twitter) with rank, URL and hashtag and promoted flags. Pick worldwide, a country or a major city.
Sample
Here's a sample run of 10 trends, showing the exact schema and results you can expect.
| # | Trend Key | Rank | Trend | Trend URL | Is Hashtag | Is Promoted | Location | Location Type | Woeid | Requested Location | As Of |
|---|---|---|---|---|---|---|---|---|---|---|---|
1 | 1|#VIVANT | 1 | #VIVANT | true | false | Worldwide | Supername | 1 | Worldwide | 2026-11-01T12:26:01Z | |
2 | 1|#GOスト | 2 | #GOスト | true | false | Worldwide | Supername | 1 | Worldwide | 2026-11-01T12:26:01Z | |
3 | 1|#豊臣兄弟 | 3 | #豊臣兄弟 | true | false | Worldwide | Supername | 1 | Worldwide | 2026-11-01T12:26:01Z | |
4 | 1|#夏色まつり古神曲ライブ | 4 | #夏色まつり古神曲ライブ | true | false | Worldwide | Supername | 1 | Worldwide | 2026-11-01T12:26:01Z | |
5 | 1|ジャミーン | 5 | ジャミーン | false | false | Worldwide | Supername | 1 | Worldwide | 2026-11-01T12:26:01Z | |
6 | 1|#BornToBeNuNewConcertD2 | 6 | #BornToBeNuNewConcertD2 | true | false | Worldwide | Supername | 1 | Worldwide | 2026-11-01T12:26:01Z | |
7 | 1|乃木さん | 7 | 乃木さん | false | false | Worldwide | Supername | 1 | Worldwide | 2026-11-01T12:26:01Z | |
8 | 1|NUNEW 2ND CON DAY2 | 8 | NUNEW 2ND CON DAY2 | false | false | Worldwide | Supername | 1 | Worldwide | 2026-11-01T12:26:01Z | |
9 | 1|チンギス | 9 | チンギス | false | false | Worldwide | Supername | 1 | Worldwide | 2026-11-01T12:26:01Z | |
10 | 1|田中真弓さん | 10 | 田中真弓さん | false | false | Worldwide | Supername | 1 | Worldwide | 2026-11-01T12:26:01Z |
Playground
Advanced parameters are collapsed below.
Fill in the fields below or .
curl -X POST "https://api.mindcase.co/v1/data/twitter/trends/run?wait=true" \
-H "Authorization: Bearer mk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"params": {
"locations": []
}
}'Related
Long-form X (Twitter) Articles with title, preview text and the full article as text and Markdown. Pass the article URLs.
A Twitter (X) account's followers or following as full profiles: bio, counts, location, links, account age and latest tweet. From a handle or URL.
Twitter (X) profiles: bio, follower counts, verification type, location and links. By handle, profile URL or keyword search; same record either way.
Every reply to a tweet as a full tweet record: author, engagement, media, quotes. The original is included, flagged so you can tell them apart.
Everyone who retweeted a tweet, each as a full Twitter (X) profile with handle, name, bio, follower counts, verification, location and links.
Extract tweets from Twitter (X) by handle, search keyword, or tweet URL, with full text, date, media, quoted/retweeted content, and all engagement metrics
Guides
X's own API gates real search and volume behind paid tiers. Here's how to pull tweets and profiles without one.
X's own API is pay-per-read now, with a 2 million-read monthly cap before you're pushed to Enterprise pricing. Here's what building against it yourself actually costs.