Overview
Every location
Worldwide, countries, and towns
One request
The whole list, with no paging
Ready to use
A WOEID for each location
Endpoint
The request needs no parameters. The list has a few hundred locations and is returned whole, so there is nothing to page through.
Example request
Example response
Example response
Location fields
Every field is returned by default, so there is no field to ask for.country, country_code, place_type, and parent_id are present when they are known. Worldwide has no country and no parent, and a location whose kind of place is not known has no place_type.
These are the same fields that Trends by WOEID returns as meta.location.
Using a location
Pass a location’swoeid to Trends by WOEID to get the trends for that place:
Migrating from v1.1
This endpoint replaces v1.1GET trends/available. It returns the same locations. The differences are in the response:
A field with no value is left out in v2. For Worldwide, v1.1 returned
"country": "", "countryCode": null, and "parentid": 0. v2 returns none of the three. Where v1.1 returned a placeType.name of Unknown, v2 returns no place_type.
Getting started
Prerequisites
- An approved developer account
- A Project and App in the Developer Console
- Your App’s Bearer Token
Trends by WOEID
Get the trends for a location
API Reference
Full endpoint documentation