GET https://xquik.com/api/v1/x/trends/history
1 credit per list returned · All plans from $0.00012/credit
GET /x/trends/history to read the Twitter trends archive of a place.
It answers what was trending on Twitter yesterday or last week. It covers any day since 2026-10-13.
Xquik stores 1 list per place every 5 minutes. It keeps each list for 25 months.
The archive starts 2026-10-13 02:20 UTC. Earlier trends are not available.
Each returned list costs 1 credit, so 24 lists cost 24 credits.
A step with no stored list returns nothing and costs nothing.
Read Twitter trends history by date
Pick the place bycountry, location, or woeid. Without one, trends are worldwide.
Set the range with from and to, and the step with every.
from and to take a time or span back from now, such as 7d. A schedule can then read the last day on every run.
The answer names the range it read in fromTime and toTime.
Each step returns the first list Xquik stored in it, oldest first.
Every list carries capturedAt, the time Xquik read it from X. Xquik never estimates that time.
A request returns 24 lists, or up to 100 with limit.
A wider range answers has_next_page as true. Send next_cursor as cursor for the next lists.
For 1 past moment, send at to Get X trends instead.Query parameters
Choose fields
Headers
Response
200 OK
400 Invalid input
An unknown place returns 400. So does afrom that is not earlier than to.
A time, step or cursor Xquik cannot read also returns 400. So does a value past its length limit.
The request costs nothing.404 No stored list
The range ends before the place’s first stored list. The message names when its archive starts. X serves no older lists. The request costs nothing.401 Unauthenticated
Anonymous requests getWWW-Authenticate: Bearer and a guest wallet checkout action. This is not a Payment challenge.402 Payment required
Account keys get account options. Guest keys get guest top-up only. No checkout starts automatically. Confirm any payment action.502 X API unavailable
The read service returned an error. Retry after a short delay.503 Service busy
Xquik is busy. Wait forRetry-After, then retry.429 Rate limit exceeded
The Xquik tier limit blocked the request. UseRetry-After when present. Otherwise, use the JSON retryAfter field.424 Dependency failed
The opt-in normalized contract returns 424 when the read service fails. Sendxquik-api-contract: 2026-04-29 to opt in. Default v1 returns 502.Twitter trends archive API questions
How do I see what was trending on Twitter yesterday?
CallGET /x/trends/history with yesterday’s date as from and today’s date as to.
Add every=1h for 1 list per hour. Add every=1d for the first list of the day.How far back does the Twitter trends archive go?
It starts 2026-10-13 02:20 UTC. Xquik keeps each list for 25 months. A range that ends before the start returns 404 and costs nothing.How often does Xquik store a list?
Every 5 minutes, for every place X offers trends for. A step under5m returns every stored list.How much does trends history cost?
Each returned list costs 1 credit, so 24 lists cost 24 credits. A step with no stored list costs nothing. A request returns 100 lists at most.What if no list matches a step?
The response leaves that step out. Xquik never fills a gap with a made-up list. Each returned list states its owncapturedAt.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.Next steps. Get X trends reads the current trends of a place. With
at, it reads 1 past moment.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." } - 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." }