Twitter follower IDs API & fast audience export

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

{
  "error": "invalid_input",
  "message": "Invalid input. Check the request body."
}

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

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

{
  "error": "x_account_protected",
  "message": "This account's follower list is private. Try a public account."
}

{
  "error": "user_not_found",
  "message": "X user not found. Check the username."
}

{
  "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

users

{id}

follower-ids

Twitter follower IDs API & fast audience export

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

package main

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

func main() {

	url := "https://xquik.com/api/v1/x/users/{id}/follower-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 result returned · All plans from $0.00012/credit · Supports guest paid reads

curl https://xquik.com/api/v1/x/users/nasa/follower-ids \
  -H "x-api-key: xq_your_api_key_here" | jq

# Page 2
curl -G https://xquik.com/api/v1/x/users/nasa/follower-ids \
  --data-urlencode "cursor=abc123" \
  -H "x-api-key: xq_your_api_key_here" | jq

const user = "nasa";
let pageCursor = "";
let position = 0;

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/users/${user}/follower-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) {
    position += 1;
    const idRow = { source_user: user, position, user_id: userId, page_cursor: pageCursor };
    process.stdout.write(`${JSON.stringify(idRow)}\n`);
  }

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

import json
import requests

user = "nasa"
page_cursor = ""
position = 0

for page_index in range(3):
    params = {"cursor": page_cursor} if page_cursor else {}
    response = requests.get(
        f"https://xquik.com/api/v1/x/users/{user}/follower-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"]:
        position += 1
        id_row = {
            "source_user": user,
            "position": position,
            "user_id": user_id,
            "page_cursor": page_cursor,
        }
        print(json.dumps(id_row, separators=(",", ":")))

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

IDs only, 5,000 a page

Use GET /x/users/{id}/follower-ids for the user IDs of a user’s followers. IDs arrive newest first. The response holds no profiles, so a page holds up to 5,000 IDs. Use it for fast audience syncs and set comparisons. Pass up to 100 IDs to GET /x/users/batch when you need profiles. Stop paging when has_next_page is false. A protected account returns 403 x_account_protected. Xquik charges nothing.

IDs or profiles?

Use GET /api/v1/x/users/{id}/follower-ids when IDs are enough.
Use GET /api/v1/x/users/{id}/followers when each row needs a profile.

Need	Route	Rows returned
IDs only	`/x/users/{id}/follower-ids`	Up to 5,000 user IDs a page.
Full profiles	`/x/users/{id}/followers`	Profiles with filters.

Path parameters

string

required

User ID, username with or without @, or URL-encoded profile URL, such as x.com/nasa. 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-5000. Defaults to 5000.

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, newest first.

boolean

Whether more results are available.

string

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

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

400 Invalid user ID

{
  "error": "invalid_user_id",
  "message": "Send a user ID, @username or profile URL, such as x.com/nasa."
}

The user ID is empty or invalid.

403 Protected account

{
  "error": "x_account_protected",
  "message": "This account's follower list is private. Try a public account."
}

404 User not found

{ "error": "user_not_found", "message": "X user not found. Check the username." }

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.

424 Dependency failed

{ "error": "x_api_unavailable" }

The normalized v1 response contract can return 424 when the read service is unavailable.

Related. Profiles on this list · Batch users · Check follower

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

{
  "error": "invalid_input",
  "message": "Invalid input. Check the request body."
}

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

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

{
  "error": "x_account_protected",
  "message": "This account's follower list is private. Try a public account."
}

{
  "error": "user_not_found",
  "message": "X user not found. Check the username."
}

{
  "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 follower IDs API & fast audience export

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

package main

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

func main() {

	url := "https://xquik.com/api/v1/x/users/{id}/follower-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 follower IDs API & fast audience export

IDs only, 5,000 a page

IDs or profiles?

Path parameters

Query parameters

Headers

Response

200 OK

400 Invalid user ID

403 Protected account

404 User not found

401 Unauthenticated

402 Payment required

502 X API unavailable

429 Rate limit exceeded

424 Dependency failed

​IDs only, 5,000 a page

​IDs or profiles?

​Path parameters

​Query parameters

​Headers

​Response

​200 OK

​400 Invalid user ID

​403 Protected account

​404 User not found

​401 Unauthenticated

​402 Payment required

​502 X API unavailable

​429 Rate limit exceeded

​424 Dependency failed

IDs only, 5,000 a page

IDs or profiles?

Path parameters

Query parameters

Headers

Response

200 OK

400 Invalid user ID

403 Protected account

404 User not found

401 Unauthenticated

402 Payment required

502 X API unavailable

429 Rate limit exceeded

424 Dependency failed