Trends
Twitter trends API for WOEID topics & hashtags
Use the Twitter Trends API to get ranked topics and hashtags by WOEID. Return search queries, ranks, public post counts, URLs, and regional result totals.
- 200
- 400
- 401
- 402
- 424
- 429
- 502
GET
Twitter trends API for WOEID topics & hashtags
Use the top-level Twitter trends API
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.
Build a regional Twitter trending monitor
UseGET /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
object[]
Ranked topic records.
Trend object fields.
string
Trend name or hashtag.
string
Optional trend description.
number
Optional ranking position.
string
Optional tweet-search query.
string | null
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
count values fall back to 30.
401 Unauthenticated
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
429 Rate limit exceeded
Retry-After before retrying.
424 Dependency failed
xquik-api-contract: 2026-04-29 to opt in. Default v1 returns 502.
Twitter trends API questions
How do I get Twitter trends programmatically?
CallGET /trends with a WOEID and result count.
Read each returned topic field described above.
Can I get location-based trending topics?
Yes. Use a listed WOEID and keep it with each rank snapshot.Does the API return historical Twitter trends?
No. Each call returns one regional snapshot. Save timestamped snapshots on the schedule you control.How do I authenticate to the Twitter trends API?
Send an account key, OAuth token, guest key, or direct MPP credential.Is the Twitter trends API free?
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 thewoeid query parameter. Use 1 for Worldwide.
Global & americas
1- Worldwide23424977- United States23424775- Canada23424900- Mexico23424768- Brazil
Europe
23424975- United Kingdom23424969- Turkey23424950- Spain23424829- Germany23424819- France
Asia
23424856- Japan23424848- India
Related. Billing & Usage · Search Tweets
- 200
- 400
- 401
- 402
- 424
- 429
- 502
Twitter trends API for WOEID topics & hashtags