Skip to main content
GET https://xquik.com/api/v1/x/trends/history
1 credit per list returned · All plans from $0.00012/credit
Use 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.
Pick the place by country, 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 a from 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 get WWW-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 for Retry-After, then retry.

429 Rate limit exceeded

The Xquik tier limit blocked the request. Use Retry-After when present. Otherwise, use the JSON retryAfter field.

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 /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.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 under 5m returns every stored list.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 own capturedAt.

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