Twitter followers API, profile export & cursors

# Username follower page
curl "https://xquik.com/api/v1/x/users/username/followers?pageSize=200" \
  -H "x-api-key: xq_your_api_key_here" | jq

# Numeric user ID follower page
curl "https://xquik.com/api/v1/x/users/44196397/followers?pageSize=200" \
  -H "x-api-key: xq_your_api_key_here" | jq

# Resume with next_cursor from the previous page
curl -G "https://xquik.com/api/v1/x/users/username/followers" \
  --data-urlencode "cursor=DAACCgACGE..." \
  --data-urlencode "pageSize=200" \
  -H "x-api-key: xq_your_api_key_here" | jq

const userIdOrUsername = "username";
let pageCursor = "";
const seenCursors = new Set();

for (let pageIndex = 0; pageIndex < 3; pageIndex += 1) {
  const params = new URLSearchParams({ pageSize: "200" });
  if (pageCursor !== "") params.set("cursor", pageCursor);

  const response = await fetch(
    `https://xquik.com/api/v1/x/users/${userIdOrUsername}/followers?${params}`,
    { headers: { "x-api-key": "xq_your_api_key_here" } },
  );
  const page = await response.json();
  if (!response.ok) throw new Error(JSON.stringify(page));

  const importRows = page.users.map((user) => ({
    source_user_id_or_username: userIdOrUsername,
    x_user_id: user.id,
    x_username: user.username,
    display_name: user.name,
    description: user.description ?? null,
    location: user.location ?? null,
    website_url: user.url ?? null,
    follower_count: user.followers ?? null,
    following_count: user.following ?? null,
    verified: user.verified ?? false,
    verified_type: user.verifiedType ?? null,
    profile_picture_url: user.profilePicture ?? null,
    cover_picture_url: user.coverPicture ?? null,
    account_created_at: user.createdAt ?? null,
    statuses_count: user.statusesCount ?? null,
    page_index: pageIndex,
    page_cursor: pageCursor,
    next_cursor: page.next_cursor,
    has_next_page: page.has_next_page,
  }));
  for (const row of importRows) process.stdout.write(`${JSON.stringify(row)}\n`);

  if (!page.has_next_page || page.next_cursor === "") break;
  if (page.next_cursor === pageCursor || seenCursors.has(page.next_cursor)) {
    throw new Error("pagination cursor repeated");
  }
  seenCursors.add(page.next_cursor);
  pageCursor = page.next_cursor;
}

import json
import requests

user_id_or_username = "44196397"
page_cursor = ""
seen_cursors = set()

for page_index in range(3):
    params = {"pageSize": "200"}
    if page_cursor:
        params["cursor"] = page_cursor

    response = requests.get(
        f"https://xquik.com/api/v1/x/users/{user_id_or_username}/followers",
        params=params,
        headers={"x-api-key": "xq_your_api_key_here"},
    )
    page = response.json()
    if not response.ok:
        raise RuntimeError(page)

    for user in page["users"]:
        import_row = {
            "source_user_id_or_username": user_id_or_username,
            "x_user_id": user["id"],
            "x_username": user["username"],
            "display_name": user["name"],
            "description": user.get("description"),
            "location": user.get("location"),
            "website_url": user.get("url"),
            "follower_count": user.get("followers"),
            "following_count": user.get("following"),
            "verified": user.get("verified", False),
            "verified_type": user.get("verifiedType"),
            "profile_picture_url": user.get("profilePicture"),
            "cover_picture_url": user.get("coverPicture"),
            "account_created_at": user.get("createdAt"),
            "statuses_count": user.get("statusesCount"),
            "page_index": page_index,
            "page_cursor": page_cursor,
            "next_cursor": page["next_cursor"],
            "has_next_page": page["has_next_page"],
        }
        print(json.dumps(import_row, separators=(",", ":")))

    if not page["has_next_page"] or not page["next_cursor"]:
        break
    if page["next_cursor"] == page_cursor or page["next_cursor"] in seen_cursors:
        raise RuntimeError("pagination cursor repeated")
    seen_cursors.add(page["next_cursor"])
    page_cursor = page["next_cursor"]