GET trends/available

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
  }
]

Was this document helpful?

Thank you

Thank you for the feedback. We’re really glad we could help!

Thank you for the feedback. How could we improve this document?

Thank you for the feedback. Your comments will help us improve our documents in the future.