Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.xquik.com/llms.txt

Use this file to discover all available pages before exploring further.

Xquik returns ranked X trends for 12 supported WOEID regions. Use each trend’s query with Search Tweets to collect matching posts.

​
Regions

Use these WOEIDs in woeid for GET /trends or GET /x/trends. Omit woeid or pass 1 for worldwide trends.

Global & Americas

  • 1 - Worldwide
  • 23424977 - United States
  • 23424775 - Canada
  • 23424900 - Mexico
  • 23424768 - Brazil

Europe

  • 23424975 - United Kingdom
  • 23424969 - Turkey
  • 23424950 - Spain
  • 23424829 - Germany
  • 23424819 - France

Asia

  • 23424856 - Japan
  • 23424848 - India

​
How it works

When you call GET /api/v1/trends, Xquik fetches the latest trending topics for the requested WOEID. Results are cached briefly to keep responses fast. Each trend includes a name, optional description, optional rank, and optional query string you can pass directly to Search Tweets. 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; valid values are 1 through 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.
Last modified on May 14, 2026