Skip to main content
GET https://xquik.com/api/v1/x/tweets/{id}/insights
1 credit per report, whatever it reads · A tweet X doesn’t have is freeAll plans from $0.00012/credit · Supports guest paid reads

How a tweet performs

Use GET /x/tweets/{id}/insights to see how fast a tweet draws engagement. It also shows how far the tweet spreads. Name the tweet by ID or URL. Engagements are likes, replies, reposts, and quotes. amplification is reposts and quotes per like, and conversation is replies per like. A rate is null when nothing divides it, such as a tweet without views.

Path parameters

Query parameters

Headers

Response

200 OK

400 Invalid input

{ "error": "invalid_tweet_id" } Send a tweet ID or a tweet URL.

404 Tweet not found

A tweet X doesn’t have is free.

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." }
  • 404 { "error": "tweet_not_found", "message": "Tweet not found. Check the tweet ID." }
  • 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." }