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)
15
Requests / 15-min window (app auth)
15

OAuth Signature Generator

Sign in to see a list of your registered applications.

Example Request

GET

https://api.twitter.com/1.1/trends/available.json

Example Result

[
  {
    "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
  }
]