Skip to main content
GET https://xquik.com/api/v1/x/tweets/{id}/retweeter-ids
Requested result counts are upper bounds for paid authenticated calls. Remaining credits may not cover the full page or ID list. If so, Xquik returns fewer results. If zero paid results are affordable, it returns 402 insufficient_credits.
1 credit per ID returned · A post nobody reposted is freeAll plans from $0.00012/credit · Supports guest paid reads

IDs of a post’s reposters

Use GET /x/tweets/{id}/retweeter-ids for the user IDs of the accounts that reposted a post. IDs arrive in the order & pages of Get retweeters, without profiles. Pass the IDs to GET /x/users/batch when you need profiles. Stop paging when has_next_page is false. A post nobody reposted returns an empty list for free. A deleted post returns 404, also free.

Path parameters

Query parameters

Headers

Response

200 OK

400 Invalid input

The post ID is empty or invalid. A cursor X cannot read returns invalid_cursor. Start again without it.

401 Unauthenticated

Anonymous requests get WWW-Authenticate: Bearer and a guest wallet checkout action. This is not a Payment challenge. Missing or invalid API key.

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.

429 Rate limit exceeded

You exceeded your tier rate limit. Wait for the Retry-After header before retrying.

Response examples

200 example

  • 400 { "error": "invalid_tweet_id", "message": "Send a tweet ID or tweet URL, such as x.com/nasa/status/20." }
  • 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." }