Twitter retweeter IDs API for a post's reposters

{
  "ids": [
    "9876543210"
  ],
  "has_next_page": true,
  "next_cursor": "1878079982871151535"
}

{
  "error": "invalid_tweet_id",
  "message": "Send a tweet ID or tweet URL, such as x.com/nasa/status/20."
}

{
  "error": "unauthenticated",
  "message": "Authentication required."
}

{
  "error": "insufficient_credits",
  "message": "Insufficient credits. Top up or subscribe to continue."
}

{
  "error": "tweet_not_found",
  "message": "Tweet not found. Check the tweet ID."
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "x_api_unavailable",
  "message": "Xquik is busy right now. Retry shortly."
}

GET

tweets

{id}

retweeter-ids

Twitter retweeter IDs API for a post's reposters

curl --request GET \
  --url https://xquik.com/api/v1/x/tweets/{id}/retweeter-ids

const options = {method: 'GET'};

fetch('https://xquik.com/api/v1/x/tweets/{id}/retweeter-ids', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/x/tweets/{id}/retweeter-ids"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "ids": [
    "<string>"
  ],
  "has_next_page": true,
  "next_cursor": "<string>"
}

Requested result counts are upper bounds for paid authenticated calls. When remaining credits cannot cover the full page or ID list, 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 free · All plans from $0.00012/credit · Supports guest paid reads

curl https://xquik.com/api/v1/x/tweets/2106061652617568263/retweeter-ids \
  -H "x-api-key: xq_your_api_key_here" | jq

const tweetId = "2106061652617568263";
let pageCursor = "";

for (let pageIndex = 0; pageIndex < 3; pageIndex += 1) {
  const params = pageCursor === "" ? "" : `?${new URLSearchParams({ cursor: pageCursor })}`;
  const response = await fetch(
    `https://xquik.com/api/v1/x/tweets/${tweetId}/retweeter-ids${params}`,
    {
      headers: { "x-api-key": "xq_your_api_key_here" },
    },
  );
  const page = await response.json();
  if (!response.ok) throw new Error(JSON.stringify(page));

  for (const userId of page.ids) {
    process.stdout.write(`${JSON.stringify({ tweet_id: tweetId, user_id: userId })}\n`);
  }

  if (!page.has_next_page || page.next_cursor === "") break;
  pageCursor = page.next_cursor;
}

import json
import requests

tweet_id = "2106061652617568263"
page_cursor = ""

for page_index in range(3):
    params = {"cursor": page_cursor} if page_cursor else {}
    response = requests.get(
        f"https://xquik.com/api/v1/x/tweets/{tweet_id}/retweeter-ids",
        params=params,
        headers={"x-api-key": "xq_your_api_key_here"},
    )
    page = response.json()
    if not response.ok:
        raise RuntimeError(page)

    for user_id in page["ids"]:
        print(json.dumps({"tweet_id": tweet_id, "user_id": user_id}))

    if not page["has_next_page"] or not page["next_cursor"]:
        break
    page_cursor = page["next_cursor"]

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 up to 100 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

string

required

Tweet ID or URL-encoded post URL. See path IDs.

Query parameters

string

Pagination cursor. Pass the next_cursor value from the previous response to fetch the next page.

integer

User IDs per page. Range: 1-200. Defaults to 200.

Headers

string

Full account key. Sessions and OAuth also work.

string

Bearer xq_your_guest_key_here for paid_reads.

Response

200 OK

string[]

User IDs of the reposters, in X’s order.

boolean

Whether more results are available.

string

Opaque cursor for the next page. Empty string when no more results.

400 Invalid input

{ "error": "invalid_tweet_id" }

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

404 Tweet not found

{ "error": "tweet_not_found" }

401 Unauthenticated

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

{ "error": "unauthenticated" }

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

{ "error": "x_api_unavailable" }

The read service returned an error. Retry after a short delay.

429 Rate limit exceeded

{ "error": "rate_limit_exceeded", "retryAfter": 60 }

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

Related. Get retweeters · Check repost · Batch users

{
  "ids": [
    "9876543210"
  ],
  "has_next_page": true,
  "next_cursor": "1878079982871151535"
}

{
  "error": "invalid_tweet_id",
  "message": "Send a tweet ID or tweet URL, such as x.com/nasa/status/20."
}

{
  "error": "unauthenticated",
  "message": "Authentication required."
}

{
  "error": "insufficient_credits",
  "message": "Insufficient credits. Top up or subscribe to continue."
}

{
  "error": "tweet_not_found",
  "message": "Tweet not found. Check the tweet ID."
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "x_api_unavailable",
  "message": "Xquik is busy right now. Retry shortly."
}

Twitter retweeter IDs API for a post's reposters

curl --request GET \
  --url https://xquik.com/api/v1/x/tweets/{id}/retweeter-ids

const options = {method: 'GET'};

fetch('https://xquik.com/api/v1/x/tweets/{id}/retweeter-ids', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/x/tweets/{id}/retweeter-ids"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "ids": [
    "<string>"
  ],
  "has_next_page": true,
  "next_cursor": "<string>"
}

Overview

X API

X write

Trends

Radar

Account

API keys

Guest wallets

Credits

X accounts

Monitors

Events

Webhooks

Draws

Extractions

Compose

Drafts

Styles

Support

Twitter retweeter IDs API for a post's reposters

IDs of a post’s reposters

Path parameters

Query parameters

Headers

Response

200 OK

400 Invalid input

404 Tweet not found

401 Unauthenticated

402 Payment required

502 X API unavailable

429 Rate limit exceeded

​IDs of a post’s reposters

​Path parameters

​Query parameters

​Headers

​Response

​200 OK

​400 Invalid input

​404 Tweet not found

​401 Unauthenticated

​402 Payment required

​502 X API unavailable

​429 Rate limit exceeded

IDs of a post’s reposters

Path parameters

Query parameters

Headers

Response

200 OK

400 Invalid input

404 Tweet not found

401 Unauthenticated

402 Payment required

502 X API unavailable

429 Rate limit exceeded