---
title: "Trend Locations"
method: GET
path: "/trends/locations"
tags: ["Trends"]
---

# Trend Locations

`GET /trends/locations`

## Request

- Base URL: `https://api.twitterapis.com/twitter`
- URL: `https://api.twitterapis.com/twitter/trends/locations`
- Auth: HTTP bearer

Fetch the full set of locations X serves trends for, each with the WOEID to pass back to the Trends endpoint. Takes no parameters and returns the complete list. Cost: $0.0008 per call.

## Query parameters

- `fields` string
- `compact` '1'

## Response `200`

List every location Twitter/X has trends available for.

- object
  - `count` integer: Number of locations returned.
  - `locations` TrendLocation[]: Location objects: name, woeid, country, country_code, parentid, place_type, url. The deprecated camelCase countryCode/placeType are still returned alongside for a migration window; prefer the snake_case country_code/place_type.
    - `name` string: Human-readable location name, for example "Worldwide", "United States", or a city name.
    - `woeid` integer: The Yahoo! Where On Earth ID for the location; pass it as the woeid parameter to the trends endpoint.
    - `country` string: Country name the location belongs to; empty string for supernames like Worldwide.
    - `countryCode` string, nullable: DEPRECATED camelCase alias of country_code, kept for a deprecation window. Prefer country_code (snake_case is our canonical convention). ISO country code for the location; null for supernames like Worldwide and for locations X reports no code for.
    - `country_code` string, nullable: ISO country code for the location; null for supernames like Worldwide and for locations X reports no code for. Canonical snake_case field (carries the same value as the deprecated camelCase countryCode).
    - `parentid` integer: WOEID of the parent location (0 for the top-level Worldwide supername).
    - `placeType` object: DEPRECATED camelCase alias of place_type, kept for a deprecation window. Prefer place_type. The location's place-type classification.
      - `code` integer: Numeric place-type code (for example 19 for a supername, 12 for a country, 7 for a town).
      - `name` string: Human-readable place-type name, for example "Supername", "Country", or "Town".
    - `place_type` object: The location's place-type classification. Canonical snake_case field (carries the same value as the deprecated camelCase placeType).
      - `code` integer: Numeric place-type code (for example 19 for a supername, 12 for a country, 7 for a town).
      - `name` string: Human-readable place-type name, for example "Supername", "Country", or "Town".
    - `url` string: The where.yahooapis.com reference URL X returns for the location.

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `402`: Insufficient credits
- `403`: Forbidden
- `404`: Not found
- `429`: Rate limited
- `5XX`: Server error

---

[API](https://skmtc.dev/twitterapis/apis/twitterapis-api.md) · [All operations](https://skmtc.dev/twitterapis/apis/twitterapis-api/llms.txt) · [OpenAPI document](https://skmtc.dev/twitterapis/apis/twitterapis-api/revisions/a33ce0fedb3c?raw)