---
title: "Twitter Trending Topics"
method: GET
path: "/v1/twitter/trends"
tags: ["Twitter"]
---

# Twitter Trending Topics

`GET /v1/twitter/trends`

## Request

- Base URL: `https://apidirect.io`
- URL: `https://apidirect.io/v1/twitter/trends`
- Auth: API key in header `X-API-Key`

Get the current trending topics for a specific location on Twitter/X. Uses WOEID (Where On Earth ID) to identify the location. Common WOEIDs: 1 (Worldwide), 23424977 (United States), 23424975 (United Kingdom), 23424775 (Canada), 23424748 (Australia), 23424848 (India), 23424856 (Japan), 23424829 (Germany), 23424819 (France), 23424768 (Brazil), 2459115 (New York), 2442047 (Los Angeles), 44418 (London), 1118370 (Tokyo). Returns trend names, search queries, search URLs, and tweet volumes where available.

**Price:** $0.006 per request. **Free tier:** 50 requests/month.

## Query parameters

- `woeid` integer, required

## Response `200`

Successful response

- TwitterTrendsResponse: Inferred from a live response. Any field can be null or absent, and new fields may be added at any time.
  - `as_of` string, nullable
  - `count` number, nullable
  - `location` string, nullable
  - `trends` object[], nullable
    - `name` string, nullable
    - `query` string, nullable
    - `tweet_volume` unknown
    - `url` string, nullable
  - `woeid` number, nullable

## Other responses

- `400`: Bad request: a required parameter is missing or a value is invalid (code: missing_parameter or invalid_parameter).
- `401`: Unauthorized: the API key is missing or invalid (code: missing_api_key or invalid_api_key).
- `402`: Free tier used up for this endpoint and no payment method on file (`payment_required`).
- `403`: Account blocked after a failed payment (`account_blocked`).
- `429`: Rate limit exceeded, or too many concurrent requests for this endpoint
- `500`: Internal server error (code: server_error).
- `502`: Temporary failure retrieving X (Twitter) data. Please retry shortly.
- `503`: Service temporarily unavailable, or no trends data is available for the requested WOEID. A WOEID with no trends coverage returns this on every call - try a different WOEID rather than retrying.
- `504`: The request timed out

---

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