Skip to main content
GET https://xquik.com/api/v1/trends
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.
1 credit per call · All plans from $0.00012/creditDirect MPP at USD 0.00015 per call
Use GET /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. Invalid count 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 for Retry-After, then retry.

429 Rate limit exceeded

Wait for Retry-After before retrying.

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 /trends with a WOEID and result count. Read each returned topic field described above.Yes. Use a listed WOEID and keep it with each rank snapshot.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.Send an account key, OAuth token, guest key, or direct MPP credential.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 the woeid query parameter. Use 1 for Worldwide.

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

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." }