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.

Note: This endpoint uses 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 for more details. The url returned in the response, where.yahooapis.com is no longer valid.

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