GetXAPI
Trends

Trend Locations

List every location X/Twitter offers trends for, with WOEIDs, via API. $0.001 per call. GetXAPI trend locations endpoint documentation.

GET/twitter/trends/locations

This endpoint costs $0.001 per API call.

List every place X (Twitter) offers trends for, so you can look up a woeid for a specific city or country not covered by the Get Trends country shortcut.

Query Parameters

None.

Response (200)

{
  "status": "success",
  "count": 467,
  "locations": [
    { "woeid": 1, "name": "Worldwide", "country": "", "country_code": null, "type": "Supername" },
    { "woeid": 23424977, "name": "United States", "country": "United States", "country_code": "US", "type": "Country" }
  ]
}

Response Fields

FieldTypeDescription
countnumberNumber of locations returned
locations[].woeidnumberYahoo WOEID — pass to Get Trends as woeid
locations[].namestringLocation name
locations[].countrystringCountry name (empty for Worldwide)
locations[].country_codestringISO country code, or null
locations[].typestringLocation type, e.g. Supername, Country, Town

Example

curl -X GET "https://api.getxapi.com/twitter/trends/locations" \
  -H "Authorization: Bearer API_KEY"

On this page