GET trends/available

API version 1.1
Updated on Thu, 2013-03-07 10:39

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

Example Request

GET

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

  1. [
  2.   {
  3.     "country": "Sweden", 
  4.     "countryCode": "SE", 
  5.     "name": "Sweden", 
  6.     "parentid": 1, 
  7.     "placeType": {
  8.       "code": 12, 
  9.       "name": "Country"
  10.     }, 
  11.     "url": "http://where.yahooapis.com/v1/place/23424954", 
  12.     "woeid": 23424954
  13.   }, 
  14.   {
  15.     "country": "United States", 
  16.     "countryCode": "US", 
  17.     "name": "New Haven", 
  18.     "parentid": 23424977, 
  19.     "placeType": {
  20.       "code": 7, 
  21.       "name": "Town"
  22.     }, 
  23.     "url": "http://where.yahooapis.com/v1/place/2458410", 
  24.     "woeid": 2458410
  25.   }, 
  26.   {
  27.     "country": "Japan", 
  28.     "countryCode": "JP", 
  29.     "name": "Sapporo", 
  30.     "parentid": 23424856, 
  31.     "placeType": {
  32.       "code": 7, 
  33.       "name": "Town"
  34.     }, 
  35.     "url": "http://where.yahooapis.com/v1/place/1118108", 
  36.     "woeid": 1118108
  37.   }, 
  38.   ...
  39.   {
  40.     "country": "United States", 
  41.     "countryCode": "US", 
  42.     "name": "Providence", 
  43.     "parentid": 23424977, 
  44.     "placeType": {
  45.       "code": 7, 
  46.       "name": "Town"
  47.     }, 
  48.     "url": "http://where.yahooapis.com/v1/place/2477058", 
  49.     "woeid": 2477058
  50.   }, 
  51.   {
  52.     "country": "United States", 
  53.     "countryCode": "US", 
  54.     "name": "Cincinnati", 
  55.     "parentid": 23424977, 
  56.     "placeType": {
  57.       "code": 7, 
  58.       "name": "Town"
  59.     }, 
  60.     "url": "http://where.yahooapis.com/v1/place/2380358", 
  61.     "woeid": 2380358
  62.   }
  63. ]