GET https://xquik.com/api/v1/x/trends
GET /x/trends to retrieve X’s ranked trends for a place you choose.
Pick the place by country, location, or woeid. Without one, trends are worldwide.
Use trends for planning, monitor setup, search jobs, and alerts.
Each example emits one JSON record for every returned trend.
Store trend_name for every result.
Keep rank, description, and query when the response includes them.
Leave omitted fields unset. Use the trend name when query is missing.
Also store region_woeid, returned_count, and your own detected_at timestamp.
Pass search_query to Search Tweets for matching tweets.
Save each snapshot before you search.
Build a regional trend monitor
Poll one WOEID on a consistent schedule. Store every trend name and returned optional field. Keep missing values unset. KeeptweetVolume as null when X returns null.
Compare ranks within the same region. Do not mix worldwide and country results
inside one ranking. Keep the WOEID on every row.
Use the returned search query to retrieve matching tweets. Keep the trend
snapshot before starting that search. Each tweet batch then links to the
regional topic that started it.
Missing tweet volume means unknown. Do not convert it to 0. X may omit
that field for some trends.Query parameters
Choose fields
Headers
Response
200 OK
location=Istanbul also names the place it read.400 Invalid input
X lists no trends for thatcountry or location. With at, so does a woeid X lists no trends for. An at that Xquik cannot read also returns 400. So does a value past its length limit. The request costs nothing.401 Unauthenticated
Missing or invalid API key.402 Payment required
Account keys receive account payment options. Guest keys receive only the guest top-up action. Anonymous calls receiveWWW-Authenticate: Payment plus a guest wallet action.
Failed requests never create checkout. Confirm a payment option first.404 No stored list
Withat, Xquik holds no list within 24 hours of that time. Before the place’s first stored list, the message names when its archive starts. X serves no older lists. Without at, a woeid X lists no trends for also returns 404. The request costs nothing.
{ "error": "not_found", "message": "Xquik stores no trends for this place before 2026-10-13 02:20 UTC. X serves no older lists, so ask for that time or later." }502 X API unavailable
The read service returned an error. Retry after a short delay.429 Rate limit exceeded
The Xquik tier limit blocked the request. UseRetry-After when present. Otherwise, use the JSON retryAfter field.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 /x/trends with a country, a location, or a woeid, and a result count.
Read each trend’s name, rank, query, description, and available tweet volume.Can I get Twitter trends by country or city name?
Yes. Sendcountry=TR or location=Istanbul. Names ignore case.
The response returns the place it read as location.Can I track trending hashtags by region?
Yes. Poll the same WOEID on a stable schedule. Compare ranks within the same region. Save each detection time. Usequery to search tweets related to each trending hashtag.
Use the trend name when the response omits query.How do I authenticate to the Twitter trends API?
Send an Xquik API key or OAuth bearer token. Apaid_reads guest key can use the API-key scheme’s Bearer alias.
For direct MPP, anonymous requests get a payment challenge.How much does a trends request cost?
The pricing callout above shows the current credit and direct MPP cost. Failed requests return a documented error without creating checkout.How do I build trend tracking into an app?
Schedule one regional request, then store each returned snapshot. Compare the latest ranks with the previous snapshot. Send rank changes you care about to a dashboard, monitor, or alert queue.Does this replace X’s official API?
No. This page documents Xquik, an independent third-party service. It does not document X’s official API.This endpoint returns trends directly from X. For broader Radar topic discovery, use List Radar Items.
Next steps. Search Tweets to find tweets about a trending topic.
Response examples
- 400
{ "error": "invalid_input", "message": "X lists no trends for that place. List places with GET /x/trends/locations." } - 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." } - 404
{ "error": "not_found", "message": "Xquik stores no trends for this place before 2026-10-13 02:20 UTC. X serves no older lists, so ask for that time or later." } - 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." }