API Direct

Twitter Trends

GET /v1/twitter/trends

Get the current trending topics for a specific location on Twitter/X. Returns trend names, search queries, and tweet volumes where available.

Cost

$0.006 per request

Free tier

50 requests/month

Parameters

woeid *

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

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
}

Your Usage

Free tier this month

Recent Activity