Trends by WOEID

Get trending topics for a specific geographic location

The Trends by WOEID endpoint returns trending topics for a specific geographic location, identified by a Yahoo! Where On Earth ID (WOEID).

Overview

Location-specific

Trends for any supported location

Global coverage

Countries, cities, and regions

Real-time

Current trending topics

---

Endpoint

Method	Endpoint	Description
GET	/2/trends/by/woeid/:id	Get trends for a WOEID

---

Common WOEIDs

Location	WOEID
Worldwide	1
United States	23424977
United Kingdom	23424975
Japan	23424856
New York	2459115
Los Angeles	2442047
London	44418
Tokyo	1118370

---

Example request

curl "https://api.x.com/2/trends/by/woeid/1" \
  -H "Authorization: Bearer $BEARER_TOKEN"

Example response

{
  "data": [
    {
      "trend_name": "#AI",
      "tweet_count": 250000
    },
    {
      "trend_name": "Breaking News",
      "tweet_count": 180000
    }
  ]
}

---

Getting started

Prerequisites

• An approved developer account
• A Project and App in the Developer Console
• Your App’s Bearer Token

Personalized trends

Get trends for the authenticated user

API Reference

Full endpoint documentation