Get locations with trending topics
API Reference contents
GET trends/available¶
Returns the locations that Twitter has trending topic information for.
The response is an array of “locations” that encode the location’s WOEID and some other human-readable information such as a canonical name and country the location belongs in.
A WOEID is a Yahoo! Where On Earth ID.
Resource URL¶
https://api.twitter.com/1.1/trends/available.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¶
None
Example Request¶
GET https://api.twitter.com/1.1/trends/available.json
Example Response¶
[
{
"country": "Sweden",
"countryCode": "SE",
"name": "Sweden",
"parentid": 1,
"placeType": {
"code": 12,
"name": "Country"
},
"url": "http://where.yahooapis.com/v1/place/23424954",
"woeid": 23424954
},
{
"country": "United States",
"countryCode": "US",
"name": "New Haven",
"parentid": 23424977,
"placeType": {
"code": 7,
"name": "Town"
},
"url": "http://where.yahooapis.com/v1/place/2458410",
"woeid": 2458410
},
{
"country": "Japan",
"countryCode": "JP",
"name": "Sapporo",
"parentid": 23424856,
"placeType": {
"code": 7,
"name": "Town"
},
"url": "http://where.yahooapis.com/v1/place/1118108",
"woeid": 1118108
},
...
{
"country": "United States",
"countryCode": "US",
"name": "Providence",
"parentid": 23424977,
"placeType": {
"code": 7,
"name": "Town"
},
"url": "http://where.yahooapis.com/v1/place/2477058",
"woeid": 2477058
},
{
"country": "United States",
"countryCode": "US",
"name": "Cincinnati",
"parentid": 23424977,
"placeType": {
"code": 7,
"name": "Town"
},
"url": "http://where.yahooapis.com/v1/place/2380358",
"woeid": 2380358
}
]
