Skip to main content
GET
Twitter trends API for WOEID topics & hashtags
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.
3 credits per call · All plans from $0.00012/credit · Direct MPP: USD 0.00045 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 two trend text fields. Map woeid and request count to the two 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. A Twitter API trends client saves each snapshot before searching. A Twitter API trending monitor compares ranks within one WOEID. Keep missing optional fields unset. Preserve null tweetVolume values.

Headers

string
Full account key. Sessions and OAuth also work.
string
Bearer xq_your_guest_key_here authenticates paid_reads guest keys. Direct MPP uses the Payment ... credential. Get it from the WWW-Authenticate: Payment challenge.

Query parameters

number
Region WOEID. See supported regions below. Omit it to use 1 for Worldwide.
number
Number of trends to return. Max 50, default 30.

Response

200 OK

Ranked topic records. Trend object fields.
string
Trend name or hashtag.
string
Optional trend description.
number
Optional ranking position.
string
Optional tweet-search query.
Optional promotion ID; null for organic trends.
number | null
Optional public post count.
string
Optional trend search URL.
number
Valid trend count before count slicing.
number
Requested region WOEID.

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 two 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.

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. No. Each call returns one regional snapshot. Save timestamped snapshots on the schedule you control. 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