Skip to main content
GET https://xquik.com/api/v1/x/trends
1 credit per call · All plans from $0.00012/creditDirect MPP at USD 0.00015 per call
Use 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. Keep tweetVolume 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

A request with location=Istanbul also names the place it read.

400 Invalid input

X lists no trends for that country 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 receive WWW-Authenticate: Payment plus a guest wallet action. Failed requests never create checkout. Confirm a payment option first.

404 No stored list

With at, 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. Use Retry-After when present. Otherwise, use the JSON retryAfter field.

424 Dependency failed

The opt-in normalized contract returns 424 when the read service fails. Send xquik-api-contract: 2026-04-29 to opt in. Default v1 returns 502.
Call GET /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.Yes. Send country=TR or location=Istanbul. Names ignore case. The response returns the place it read as location.Yes. Poll the same WOEID on a stable schedule. Compare ranks within the same region. Save each detection time. Use query to search tweets related to each trending hashtag. Use the trend name when the response omits query.Send an Xquik API key or OAuth bearer token. A paid_reads guest key can use the API-key scheme’s Bearer alias. For direct MPP, anonymous requests get a payment challenge.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." }