Overview
Posts
Users
Direct Messages
Lists
Spaces
Communities
Community Notes
Media
X Activity
Stream Connections
Compliance
Trends
Get Trends by WOEID
Retrieves trending topics for a specific location identified by its WOEID.
GET
/
2
/
trends
/
by
/
woeid
/
{woeid}
Get Trends by WOEID
curl --request GET \
--url https://api.x.com/2/trends/by/woeid/{woeid} \
--header 'Authorization: Bearer <token>'{
"data": [
{
"trend_name": "<string>",
"tweet_count": 123
}
],
"errors": [
{
"title": "<string>",
"type": "<string>",
"detail": "<string>",
"status": 123
}
]
}Documentation Index
Fetch the complete documentation index at: https://docs.x.com/llms.txt
Use this file to discover all available pages before exploring further.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
The WOEID of the place to lookup a trend for.
Query Parameters
The maximum number of results.
Required range:
1 <= x <= 50A comma separated list of Trend fields to display. The fields available for a Trend object.
Minimum array length:
1Available options:
trend_name, tweet_count Example:
["trend_name", "tweet_count"]Response
The request has succeeded.
Minimum array length:
1Show child attributes
Show child attributes
Minimum array length:
1An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).
- Option 1
- Option 2
- Option 3
- Option 4
- Option 5
- Option 6
- Option 7
- Option 8
- Option 9
- Option 10
- Option 11
- Option 12
- Option 13
- Option 14
- Option 15
- Option 16
- Option 17
- Option 18
Show child attributes
Show child attributes
⌘I
Get Trends by WOEID
curl --request GET \
--url https://api.x.com/2/trends/by/woeid/{woeid} \
--header 'Authorization: Bearer <token>'{
"data": [
{
"trend_name": "<string>",
"tweet_count": 123
}
],
"errors": [
{
"title": "<string>",
"type": "<string>",
"detail": "<string>",
"status": 123
}
]
}