Skip to main content
The Trends by WOEID endpoint returns trending topics for a specific geographic location, identified by a Yahoo! Where On Earth ID (WOEID).

Overview

Location-specific

Trends for any supported location

Global coverage

Countries, cities, and regions

Real-time

Current trending topics

Endpoint


Common WOEIDs

For every location that has trends, with its WOEID, use Trend Locations.

Example request

Example response

Example response

Post counts

tweet_count is the number of posts that match the trend in the last 24 hours, including reposts. It is returned by default, so there is no field to ask for. A trend has a tweet_count only when it has at least 1,000 posts in that time. Below that, the field is left out, as for Breaking News in the example above. A count can be up to about 10 minutes old. If you are moving from v1.1 GET trends/place, tweet_count takes the place of tweet_volume.

Location

meta.location describes the place the trends are for. It 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:
Location for Worldwide (WOEID 1)

Getting started

Prerequisites

Trend locations

Get every location that has trends

Personalized trends

Get trends for the authenticated user

API Reference

Full endpoint documentation