GET trends/place
Returns the top 50 trending topics for a specific id, if
trending information is available for it.
Note: The id parameter for this endpoint is the "where
on earth identifier" or WOEID, which is a legacy identifier created by
Yahoo and has been deprecated. Twitter API v1.1 still uses the numeric
value to identify town and country trend locations. Reference our legacy
blog
post, or archived
data
Example WOEID locations include: Worldwide: 1 UK: 23424975 Brazil: 23424768 Germany: 23424829 Mexico: 23424900 Canada: 23424775 United States: 23424977 New York: 2459115
To identify other ids, please use the GET trends/available endpoint.
The response is an array of trend objects that encode
the name of the trending topic, the query parameter that can be used to
search for the topic on Twitter
Search, and the Twitter Search URL.
The most up to date info available is returned on request. The
created_at field will show when the oldest trend started
trending. The as_of field contains the timestamp when the
list of trends was created.
The tweet_volume for the last 24 hours is also returned
for many trends if this is available.
Resource URL¶
https://api.twitter.com/1.1/trends/place.json
Resource Information¶
| Response formats | JSON |
| Requires authentication? | Yes |
| Rate limited? | Yes |
| Requests / 15-min window (user auth) | 75 |
| Requests / 15-min window (app auth) | 75 |
Parameters¶
| Name | Required | Description | Default Value | Example |
| id | required | The numeric value that represents the location from where to return trending information for from. Formerly linked to the Yahoo! Where On Earth ID Global information is available by using 1 as the WOEID . | 1 | |
| exclude | optional | Setting this equal to hashtags will remove all hashtags from the trends list. |
Example Request¶
GET https://api.twitter.com/1.1/trends/place.json?id=1
Example Response¶
[
{
"trends": [
{
"name": "#GiftAGamer",
"url": "http://twitter.com/search?q=%23GiftAGamer",
"promoted_content": null,
"query": "%23GiftAGamer",
"tweet_volume": null
},
{
"name": "#AskCuppyAnything",
"url": "http://twitter.com/search?q=%23AskCuppyAnything",
"promoted_content": null,
"query": "%23AskCuppyAnything",
"tweet_volume": 14504
},
{
"name": "#givethanks",
"url": "http://twitter.com/search?q=%23givethanks",
"promoted_content": null,
"query": "%23givethanks",
"tweet_volume": null
},
{
"name": "Carrefour",
"url": "http://twitter.com/search?q=Carrefour",
"promoted_content": null,
"query": "Carrefour",
"tweet_volume": 438616
},
{
"name": "#StreamLifeGoesOn",
"url": "http://twitter.com/search?q=%23StreamLifeGoesOn",
"promoted_content": null,
"query": "%23StreamLifeGoesOn",
"tweet_volume": 179026
},
{
"name": "STREAM BE PARTY",
"url": "http://twitter.com/search?q=%22STREAM+BE+PARTY%22",
"promoted_content": null,
"query": "%22STREAM+BE+PARTY%22",
"tweet_volume": 71404
},
{
"name": "#TransDayOfRemembrance",
"url": "http://twitter.com/search?q=%23TransDayOfRemembrance",
"promoted_content": null,
"query": "%23TransDayOfRemembrance",
"tweet_volume": 45852
},
{
"name": "Mourão",
"url": "http://twitter.com/search?q=Mour%C3%A3o",
"promoted_content": null,
"query": "Mour%C3%A3o",
"tweet_volume": 12614
},
{
"name": "Taysom Hill",
"url": "http://twitter.com/search?q=%22Taysom+Hill%22",
"promoted_content": null,
"query": "%22Taysom+Hill%22",
"tweet_volume": 20311
},
{
"name": "Geraldo",
"url": "http://twitter.com/search?q=Geraldo",
"promoted_content": null,
"query": "Geraldo",
"tweet_volume": 30166
}
],
"as_of": "2020-11-20T19:37:52Z",
"created_at": "2020-11-19T14:15:43Z",
"locations": [
{
"name": "Worldwide",
"woeid": 1
}
]
}
]