List trends

3 credits per call · All plans from $0.00012/credit

curl "https://xquik.com/api/v1/trends?woeid=23424977&count=10" \
  -H "x-api-key: xq_YOUR_KEY_HERE" | jq

Direct trends handoff

Use GET /trends when a dashboard, alerting job, content queue, warehouse, or agent needs ranked X topics for a supported WOEID region. The Node.js, Python, and Go examples shape one JSON line per trend. Store trend_name, rank, description, search_query, region_woeid, requested_count, and returned_total. Pass search_query to Search Tweets when the next step needs matching tweets. total is the number of valid trends available before count slicing. Use it to detect whether a smaller count hid extra rows.

Headers

x-api-key

string

required

Your API key. Generate one from the API Keys page.

Query parameters

woeid

number

Region WOEID. See supported regions below. Default: 1 (Worldwide).

count

number

Number of trends to return. Max 50, default 30.

Response

trends

object[]

Array of trending topics.

Show trend object

name

string

Trend name or hashtag.

description

string

Short description. Omitted if unavailable.

rank

number

Position in the trending list. Omitted if unavailable.

query

string

Search query for this trend. Omitted if unavailable.

total

number

Full count of available trends before slicing by count.

woeid

number

Region WOEID used for this request.

{
  "trends": [
    {
      "name": "#SuperBowl",
      "description": "Trending in United States",
      "rank": 1,
      "query": "%23SuperBowl"
    },
    {
      "name": "Taylor Swift",
      "rank": 2,
      "query": "%22Taylor%20Swift%22"
    }
  ],
  "total": 50,
  "woeid": 1
}

{ "error": "invalid_input" }

Unsupported or malformed woeid. Use one of the WOEIDs in the regions table. count is clamped between 1 and 50; nonnumeric values fall back to 30.

{ "error": "unauthenticated" }

Missing or invalid API key. Check the x-api-key header value.

{ "error": "no_subscription" }

No active subscription or insufficient credits. Possible error values: no_subscription, subscription_inactive, no_credits, insufficient_credits. For MPP requests without a valid payment credential, 402 returns a WWW-Authenticate: Payment challenge header instead.

{ "error": "x_api_unavailable" }

The read service is temporarily unavailable. Retry with exponential backoff.

{ "error": "rate_limit_exceeded", "retryAfter": 60 }

Your tier rate limit was exceeded. Wait for the Retry-After header before retrying.

{ "error": "x_api_unavailable" }

The normalized v1 response contract can return 424 when the read service is unavailable.

Regions

Use these WOEIDs in the woeid query parameter. Omit woeid or pass 1 for worldwide trends.

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

Related: Billing & Usage · Search Tweets

Overview

X API

X Write

Trends

Radar

Account

API Keys

Credits

X Accounts

Monitors

Events

Webhooks

Draws

Extractions

Compose

Drafts

Styles

Support

Direct trends handoff

Headers

Query parameters

Response

Regions

Global & Americas

Europe

Asia

Overview

X API

X Write

Trends

Radar

Account

API Keys

Credits

X Accounts

Monitors

Events

Webhooks

Draws

Extractions

Compose

Drafts

Styles

Support

Documentation Index

​Direct trends handoff

​Headers

​Query parameters

​Response

​Regions

Global & Americas

Europe

Asia

Direct trends handoff

Headers

Query parameters

Response

Regions