Skip to main content
GET https://xquik.com/api/v1/x/tweets/top
1 credit per tweet · Up to 100 tweets per listAll plans from $0.00012/credit · Supports guest paid reads

The tweets X ranks highest

Use GET /x/tweets/top to list the tweets X ranks highest by one metric. Pick the metric and how far back to look. Narrow it to one country or one language. Leave both out to cover all of X. Pages hold up to 20 tweets. Pass next_cursor as cursor for the next page. The list ends at 100 tweets.

Query parameters

Choose fields

Headers

Response

200 OK

400 Invalid input

{ "error": "invalid_input", "message": "Send country or language, not both." } The message says which parameter to fix.

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.

Response examples

200 example

  • 400 { "error": "invalid_input", "message": "Invalid input. Check the request body." }
  • 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." }
  • 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." }