Skip to main content
Xquik surfaces real-time trending topics from X across 12 regions. Trends are free for all subscribers — they do not consume any usage quota. Data is cached and auto-refreshes every 15 minutes.

​
Regions

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

​
How It Works

Trend data is stored in the database and synced from X every 15 minutes per region. When you call GET /api/v1/trends, you receive the latest cached snapshot for the requested WOEID. No X API call is made at request time, which is why trends are free and 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. 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_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2" \
  | 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_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2" | jq

​
Next Steps

Trends API Reference

Full endpoint reference with query parameters and response schema.

Billing & Usage

Subscription pricing, usage quotas, and monthly operation limits.