GET trends/closest

Returns the locations that Twitter has trending topic information for, closest to a specified location.

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/closest.json

Resource Information

Response formats

JSON

Requires authentication?

Yes

Rate limited?

Yes

Requests / 15-min window (user auth)

Requests / 15-min window (app auth)

Parameters

lat required

If provided with a long parameter the available trend locations will be sorted by distance, nearest to furthest, to the co-ordinate pair. The valid ranges for longitude is -180.0 to +180.0 (West is negative, East is positive) inclusive.

Example Values: 37.781157

long required

If provided with a lat parameter the available trend locations will be sorted by distance, nearest to furthest, to the co-ordinate pair. The valid ranges for longitude is -180.0 to +180.0 (West is negative, East is positive) inclusive.

Example Values: -122.400612831116

OAuth Signature Generator

Example Request

GET 
https://api.twitter.com/1.1/trends/closest.json?lat=37.781157&long=-122.400612831116

Example Result

[
  {
    "country": "Australia", 
    "countryCode": "AU", 
    "name": "Australia", 
    "parentid": 1, 
    "placeType": {
      "code": 12, 
      "name": "Country"
    }, 
    "url": "http://where.yahooapis.com/v1/place/23424748", 
    "woeid": 23424748
  }
]