Skip to main content
The Trend Locations endpoint returns every location that X has trends for. Each location has a Yahoo! Where On Earth ID (WOEID), which you pass to Trends by WOEID to get the trends for that place.

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’s woeid to Trends by WOEID to get the trends for that place:
The list of locations changes rarely. You can request it once and store it, then refresh it from time to time, such as once a day.

Migrating from v1.1

This endpoint replaces v1.1 GET 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

Trends by WOEID

Get the trends for a location

API Reference

Full endpoint documentation