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