Twitter Trends API

Endpoint

GET /v1/twitter/trends

Parameters

woeid *

Where On Earth ID for the location. Use 1 for Worldwide.

Response fields

trends

Array of trending topics

name

Trend name or hashtag

query

URL-encoded search query

tweet_volume

Estimated tweet volume (null when unavailable)

url

Twitter search URL for this trend

location

Name of the location

woeid

WOEID used

as_of

Timestamp of when trends were captured

count

Number of trends returned

Example Request

curl "https://apidirect.io/v1/twitter/trends?woeid=1" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

response = requests.get(
    "https://apidirect.io/v1/twitter/trends",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={"woeid": 1}
)
print(response.json())

Example Response

{
  "trends": [
    {
      "name": "#TrendingTopic",
      "query": "%23TrendingTopic",
      "tweet_volume": 125000,
      "url": "http://twitter.com/search?q=%23TrendingTopic"
    },
    {
      "name": "Breaking News",
      "query": "%22Breaking+News%22",
      "tweet_volume": null,
      "url": "http://twitter.com/search?q=%22Breaking+News%22"
    }
  ],
  "location": "Worldwide",
  "woeid": 1,
  "as_of": "2026-03-05T01:23:37Z",
  "count": 50
}

Frequently asked questions

What is a WOEID?

WOEID (Where On Earth ID) is a unique identifier for locations. Use 1 for Worldwide, or download the full list of 467 available locations from the documentation.

How often do trends update?

Trends are refreshed in near real-time by Twitter. Each request returns the latest available trends for the specified location.

What is tweet_volume?

Tweet volume is the estimated number of tweets about this trend in the last 24 hours. It may be null for some trends where volume data is not available.

How does pricing work?

You only pay for successful requests. The Twitter Trends API costs $0.006 per request. There are no monthly fees or commitments. You get 50 free requests per endpoint every month.

Do I need a credit card to start?

No. You can sign up and use the free tier (50 requests/endpoint/month) without adding a payment method. You only need to add a card when you want to exceed the free tier.

Are there rate limits?

Yes, there's a concurrency limit of 3 simultaneous requests per endpoint per user. If you need more, just get in touch.