Skip to main content
Xquik surfaces real-time trending topics from X across 12 regions. Data refreshes with each request.

​
Regions

WOEIDRegion
1Worldwide
23424977United States
23424975United Kingdom
23424969Turkey
23424950Spain
23424829Germany
23424819France
23424856Japan
23424848India
23424768Brazil
23424775Canada
23424900Mexico

​
How it works

When you call GET /api/v1/trends, Xquik fetches the latest trending topics for the requested WOEID. Results are cached in-process to keep responses fast. Each trend includes a name (the topic or hashtag), an optional description, a rank position, and a query string you can pass directly to the Search Tweets endpoint. Response: 
{
  "woeid": 23424977,
  "total": 30,
  "trends": [
    {
      "name": "#AI",
      "description": "Artificial Intelligence discussions",
      "rank": 1,
      "query": "#AI"
    }
  ]
}
The count query parameter controls how many trends to return. Defaults to 30, minimum 1, maximum 50. Fetch the top trend for a region, then search for tweets about it: 
# 1. Get top trend
TREND=$(curl -s "https://xquik.com/api/v1/trends?woeid=23424977&count=1" \
  -H "x-api-key: xq_YOUR_KEY_HERE" \
  | jq -r '.trends[0].query')

# 2. Search tweets about it
curl -G "https://xquik.com/api/v1/x/tweets/search" \
  --data-urlencode "q=$TREND" \
  -H "x-api-key: xq_YOUR_KEY_HERE" | jq

​
Next steps

Trends API Reference

Full endpoint reference with query parameters and response schema.

Billing & Usage

Subscription pricing, credits, and per-operation costs.