GET https://xquik.com/api/v1/trends
Use the top-level Twitter trends API
GET /trends is Xquik’s top-level alias for ranked WOEID topics.
It returns total. /x/trends returns count instead.
Keep one response shape throughout each client.Build a regional Twitter trending monitor
UseGET /trends for regional dashboards, alerts, queues, warehouses, or agents.
The examples emit one JSON line per trend.
Store trend_name, rank, description, and search_query.
Record region_woeid and requested_count with each snapshot.
Record returned_total beside those request fields.
Map name and query to the 2 trend text fields.
Map woeid and request count to the 2 request fields.
Derive returned_total from trends.length.
The raw total counts valid trends before count slicing.
Pass search_query to Search Tweets.
That search finds related tweets, hashtags, or brand mentions.
Save each snapshot before you search.
Compare ranks only within one WOEID.
Keep missing optional fields unset. Store null tweetVolume values as null.Headers
Query parameters
Choose fields
Response
200 OK
400 Invalid input
Use a supported WOEID. Invalidcount values fall back to 30.401 Unauthenticated
Replace the missing or invalid API key.402 Payment required
Account keys get account options. Guest keys get a top-up option. Anonymous direct MPP shows 2 payment choices. Choose either the payment challenge or the guest wallet action. No checkout starts automatically.502 X API unavailable
The read service failed. Retry after a short delay.503 Service busy
Xquik is busy. Wait forRetry-After, then retry.429 Rate limit exceeded
Wait forRetry-After before retrying.424 Dependency failed
The opt-in normalized contract returns 424 when the read service fails. Sendxquik-api-contract: 2026-04-29 to opt in. Default v1 returns 502.Twitter trends API questions
How do I get Twitter trends programmatically?
CallGET /trends with a WOEID and result count.
Read each returned topic field described above.Can I get location-based trending topics?
Yes. Use a listed WOEID and keep it with each rank snapshot.Does the API return historical Twitter trends?
This route returns the current list only.GET /x/trends takes at for a past time, and Get trends history returns a range.
The archive starts 2026-10-13 02:20 UTC.How do I authenticate to the Twitter trends API?
Send an account key, OAuth token, guest key, or direct MPP credential.Is the Twitter trends API free?
No. The pricing callout shows each successful call’s cost.Does this replace X’s official API?
No. This page documents Xquik, an independent third-party service. It does not document X’s official trends endpoint.Regions
Use these WOEIDs in thewoeid query parameter. Use 1 for Worldwide.Global & Americas
1- Worldwide23424977- United States23424775- Canada23424900- Mexico23424768- Brazil
Europe
23424975- United Kingdom23424969- Turkey23424950- Spain23424829- Germany23424819- France
Asia
23424856- Japan23424848- India
Related. Billing & Usage · Search Tweets
Response examples
- 400
{ "error": "invalid_input", "message": "Invalid input. Check the request body." } - 401
{ "error": "unauthenticated", "message": "Authentication required. Provide a valid API key or bearer token." } - 402
{ "error": "insufficient_credits", "message": "Insufficient credits. Top up or subscribe to continue." } - 403
{ "error": "api_key_paused", "message": "This API key is paused. Resume it at dashboard.xquik.com/api-keys to use it again." } - 424
{ "error": "x_api_unavailable", "message": "X data source temporarily unavailable. Try again later." } - 429
{ "error": "rate_limit_exceeded", "message": "Too many requests. Try again later.", "retryAfter": 60 } - 502
{ "error": "x_api_unavailable", "message": "X data source temporarily unavailable. Try again later." } - 503
{ "error": "x_api_unavailable", "message": "Xquik is busy right now. Retry shortly." }