Twitter list followers API & profile export

{
  "users": [],
  "has_next_page": false,
  "next_cursor": ""
}

{
  "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": "not_found",
  "message": "Resource not found."
}

{
  "error": "coverage_cursor_unavailable",
  "message": "Cursor busy. Retry after the indicated delay."
}

{
  "error": "coverage_cursor_gone",
  "message": "Cursor finished, expired, or superseded. Restart pagination without cursor."
}

{
  "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": "Maximum coverage is busy. Retry shortly."
}

GET

lists

{id}

followers

Twitter list followers API & profile export

curl --request GET \
  --url https://xquik.com/api/v1/x/lists/{id}/followers

package main

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

func main() {

	url := "https://xquik.com/api/v1/x/lists/{id}/followers"

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

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

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

	fmt.Println(string(body))

}

{
  "users": [
    {
      "id": "<string>",
      "username": "<string>",
      "name": "<string>",
      "description": "<string>",
      "followers": 123,
      "following": 123,
      "verified": true,
      "profilePicture": "<string>",
      "location": "<string>",
      "createdAt": "<string>",
      "statusesCount": 123,
      "coverPicture": "<string>",
      "mediaCount": 123,
      "url": "<string>",
      "favouritesCount": 123,
      "hasCustomTimelines": true,
      "isTranslator": true,
      "withheldInCountries": [
        "<string>"
      ],
      "possiblySensitive": true,
      "pinnedTweetIds": [
        "<string>"
      ],
      "isAutomated": true,
      "automatedBy": "<string>",
      "unavailable": true,
      "unavailableReason": "<string>",
      "verifiedType": "<string>",
      "profile_bio": {},
      "isBlueVerified": true,
      "isVerified": true,
      "profileBannerUrl": "<string>",
      "protected": true,
      "communityRole": "<string>"
    }
  ],
  "has_next_page": true,
  "next_cursor": "<string>"
}

This API returns one List’s follower IDs, usernames, bios, locations, verification, public counts, profile images, and cursors.

Omit mode for automatic maximum coverage. Xquik combines available views within a short request window. It keeps the existing response shape. Pass next_cursor back unchanged as cursor. Keep the same endpoint, target, query, and filters.

Existing unprefixed cursors keep their legacy behavior. after, limit, and pageSize aliases also keep working. Billing still counts only returned rows. Use mode=standard only to force legacy single-view pagination. A page can be empty or underfilled. Continue while has_next_page is true. Stop only after the response reports has_next_page=false. First-page requests do not support Idempotency-Key retries. Repeating a cursorless request starts a separate extraction. Results returned by that extraction incur their normal charges. Save each response before requesting its next page. You cannot replay earlier or terminal responses after their cursors become unavailable. If automatic coverage is busy, an initial request returns a standard data page. Live coverage cursors remain atomic. Concurrent use returns 409 coverage_cursor_unavailable with exact Retry-After seconds. Wait, then retry the same cursor once. Repeated busy responses never authorize restarting with another cursor. Finished, expired, superseded, or identity-mismatched cursors return 410 coverage_cursor_gone. The response omits Retry-After. Restart without a cursor. Keep received results. Deduplicate restarted results by id. Malformed cursors return 400 invalid_coverage_cursor. Restart without them.

Twitter list followers questions

What is a Twitter list follower?

A List follower subscribes to one List. A List member is an account selected by the List owner. An account follower follows one profile instead. X says anyone can follow a public List. Only its owner can access a private List. Read X’s official Lists guide for current List visibility and follow behavior.

How do I find who follows a specific Twitter list?

Copy the numeric List ID from its X URL. Request the first page without a cursor. Store every returned user row before requesting another page. Xquik returns has_next_page and next_cursor. Continue only when has_next_page is true. Pass next_cursor unchanged as the next cursor. X also documents a List follower route. Its official Get List followers guide uses different pagination field names.

How do I export Twitter list followers?

The direct endpoint returns JSON pages with named fields. Convert each profile into one row. Store the List ID, user ID, username, bio, counts, and request time. Use list_follower_explorer for a saved Twitter List follower export. The job can produce CSV, JSON, or XLSX files without custom spreadsheet code.

What can I check in each Twitter profile?

Check user IDs, usernames, bios, and public location text. Check when each account began, its verified status, and its public counts. Check automated, protected, and unavailable flags only when the response includes them. These fields do not show age, gender, income, identity, consent, or sentiment. A profile location does not prove where someone lives.

Can this API add, remove, or buy list followers?

No. This read endpoint cannot follow a List or remove a List follower. It cannot create Lists, manage List members, publish posts, or buy followers. Use the List Members endpoint for the curated profile roster. That endpoint also reads profiles. It does not edit the List.

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

curl "https://xquik.com/api/v1/x/lists/1234567890/followers" \
  -H "x-api-key: xq_your_api_key_here" | jq

const listId = "1234567890";
const response = await fetch(`https://xquik.com/api/v1/x/lists/${listId}/followers`, {
  headers: { "x-api-key": "xq_your_api_key_here" },
});
const data = await response.json();
const followerRows = data.users.map((user) => ({
  list_id: listId,
  follower_id: user.id,
  username: user.username,
  display_name: user.name,
  bio: user.description ?? null,
  follower_count: user.followers ?? null,
  following_count: user.following ?? null,
  verified: user.verified ?? false,
  profile_image_url: user.profilePicture ?? null,
}));
const nextCursor = data.has_next_page ? data.next_cursor : null;

import requests

list_id = "1234567890"
response = requests.get(
    f"https://xquik.com/api/v1/x/lists/{list_id}/followers",
    headers={"x-api-key": "xq_your_api_key_here"},
)
data = response.json()
follower_rows = [
    {
        "list_id": list_id,
        "follower_id": user["id"],
        "username": user["username"],
        "display_name": user["name"],
        "bio": user.get("description"),
        "follower_count": user.get("followers"),
        "following_count": user.get("following"),
        "verified": user.get("verified", False),
        "profile_image_url": user.get("profilePicture"),
    }
    for user in data["users"]
]
next_cursor = data["next_cursor"] if data["has_next_page"] else None

Direct list follower handoff

GET /x/lists/{id}/followers examples build one row per List follower. Send saved rows to a CRM, warehouse, audience tool, or agent. Use list_follower_explorer for a saved job and CSV, JSON, or XLSX export. Store list_id, follower_id, username, and display_name. Keep profile counts, verified state, has_next_page, and next_cursor.

List follower audience

Page accounts that follow the list. Store the row shape above for CRM, warehouse, and audience imports.

Store has_next_page and next_cursor. Only request another page when has_next_page is true.

Default page

Direct calls use the default paid page size. The returned users.length is the row count for this page.

Saved export

Use list_follower_explorer when the workflow needs a saved job with CSV, JSON, or XLSX output.

Measure Twitter list follower profiles

Use List followers for profiles that chose to follow one List. Keep the List ID with every profile. This keeps follower rows apart from List member rows. Save these fields:

User ID, username, and profile name.
Bio, location, and verified state.
Follower and following counts.
List ID, cursor, and collection time.

Compare List follower snapshots by user ID. Record new and missing IDs on separate lines. A new username does not mean a new follower. Use list members when you need the list owner’s curated roster. Use account followers when you need the audience of one profile. Each endpoint returns a different relationship. For outreach review, keep source list context. Never infer consent or contact permission from a public follow relationship.

Track list audience changes

Finish both follower snapshots before finding added or missing IDs. Record the List ID, request time, page count, and final row count. Use follower user IDs as stable match keys. Keep usernames as labels. Mark stopped or credit-limited jobs as partial. A snapshot diff shows the List followers seen in each run. It does not show changes to the List’s member roster. Report newly observed follower IDs separately from missing IDs. Keep both snapshot completion states beside the comparison. Use snapshot differences to review the audience only. A public follow does not grant outreach rights or prove interest in every List topic.

Path parameters

string

required

List ID (numeric string).

Query parameters

string

Pass next_cursor back unchanged. Xquik cursors resume automatic coverage. Existing unprefixed cursors keep legacy behavior.

string

Omit mode for automatic maximum coverage. Use standard for legacy pagination. Use coverage for one diagnostic response without cursors.

string

Legacy cursor alias for cursor. When both are present, cursor wins.

integer

Automatic pages accept 1-300. Standard pages accept 1-200. Default: 200.

Which list endpoint?

List followers

Use GET /x/lists/{id}/followers for accounts that follow the list.

List members

Use GET /x/lists/{id}/members for accounts the list owner added to the list.

List tweets

Use GET /x/lists/{id}/tweets for tweets from accounts in the list.

Bulk list jobs

Use Create extraction with list_follower_explorer, list_member_extractor, or list_post_extractor when the workflow needs a saved export.

User result filters

These filters apply before billing. Selective filters can return fewer rows.

integer

Require this minimum follower count. Filtering happens before billing.

integer

Allow this maximum follower count. Missing counts pass this filter.

integer

Require this minimum following count.

integer

Allow this maximum following count. Missing counts pass this filter.

integer

Require this minimum post count.

integer

Allow this maximum post count. Missing counts pass this filter.

integer

Require this minimum account age in days.

boolean

When true, only return verified profiles.

string

Match the exact verification type.

boolean

When true, require a profile website.

boolean

When true, require a profile location.

string

Require every comma-separated or line-separated bio term.

string

Require this text in the profile location.

string

Require this text in the username.

Headers

string

Full account key. Sessions and OAuth also work.

string

Bearer xq_your_guest_key_here for paid_reads.

Response

200 OK

object[]

Array of list followers. User object fields.

string

User ID.

string

X username.

string

Display name.

string

Contains the profile bio.

number

Shows how many accounts follow this profile.

number

Shows how many accounts this profile follows.

boolean

Shows if X marks this profile as verified.

string

Links to the profile image.

string

Shows the location written on the profile.

string

Shows when the account began, in ISO 8601 format.

number

Shows the post count if X returns it.

string

Links to the cover image if X returns it.

number

Shows the media post count if X returns it.

string

Website URL from profile. Omitted if empty.

number

Shows how many posts this account liked if X returns it.

boolean

Shows custom timelines if X returns this field.

boolean

Shows X translator status if X returns it.

string[]

Lists country codes where X withholds this account. Omitted if empty.

boolean

Shows if X marks the account as sensitive. Omitted if X does not send it.

string[]

Lists pinned Tweet IDs. Omitted if none.

boolean

Shows if X marks this account as automated. Omitted if X does not send it.

string

Names the operator. Omitted when the account is not automated.

boolean

Shows if X could not load the account. Omitted when X loads it.

string

Explains why X could not load the account. Omitted when X loads it.

string

Shows Business or Government status. Omitted for blue checks or unverified profiles.

object

Adds the structured bio and its tags. Omitted if X does not send it.

boolean

Shows if X Premium verifies the account. Omitted if X does not send it.

boolean

Shows the normalized verified state. Omitted if X does not send it.

string

Links to the profile banner. Omitted if X does not send it.

boolean

Shows if the account protects its posts. Omitted if X does not send it.

string

Shows a community role only in community results.

boolean

Shows if another page exists.

string

Gives the next cursor. Pass it as the cursor query value.

{
  "users": [
    {
      "id": "987654321",
      "username": "username",
      "name": "Xquik",
      "followers": 10000,
      "verified": true
    }
  ],
  "has_next_page": true,
  "next_cursor": "DAACCgACGE..."
}

400 Invalid list ID

{ "error": "invalid_list_id", "message": "List ID required" }

The list ID path parameter is empty.

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.

404 List not found

{ "error": "not_found" }

Xquik could not resolve the list. Check the list ID.

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’s rate limit. Wait for the Retry-After header before retrying.

424 Dependency failed

{ "error": "x_api_unavailable" }

The v1 response can return 424 when the read service fails.

Related. List Members · List Tweets

{
  "users": [],
  "has_next_page": false,
  "next_cursor": ""
}

{
  "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": "not_found",
  "message": "Resource not found."
}

{
  "error": "coverage_cursor_unavailable",
  "message": "Cursor busy. Retry after the indicated delay."
}

{
  "error": "coverage_cursor_gone",
  "message": "Cursor finished, expired, or superseded. Restart pagination without cursor."
}

{
  "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": "Maximum coverage is busy. Retry shortly."
}

Twitter list followers API & profile export

curl --request GET \
  --url https://xquik.com/api/v1/x/lists/{id}/followers

package main

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

func main() {

	url := "https://xquik.com/api/v1/x/lists/{id}/followers"

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

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

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

	fmt.Println(string(body))

}

{
  "users": [
    {
      "id": "<string>",
      "username": "<string>",
      "name": "<string>",
      "description": "<string>",
      "followers": 123,
      "following": 123,
      "verified": true,
      "profilePicture": "<string>",
      "location": "<string>",
      "createdAt": "<string>",
      "statusesCount": 123,
      "coverPicture": "<string>",
      "mediaCount": 123,
      "url": "<string>",
      "favouritesCount": 123,
      "hasCustomTimelines": true,
      "isTranslator": true,
      "withheldInCountries": [
        "<string>"
      ],
      "possiblySensitive": true,
      "pinnedTweetIds": [
        "<string>"
      ],
      "isAutomated": true,
      "automatedBy": "<string>",
      "unavailable": true,
      "unavailableReason": "<string>",
      "verifiedType": "<string>",
      "profile_bio": {},
      "isBlueVerified": true,
      "isVerified": true,
      "profileBannerUrl": "<string>",
      "protected": true,
      "communityRole": "<string>"
    }
  ],
  "has_next_page": true,
  "next_cursor": "<string>"
}

​Twitter list followers questions

​What is a Twitter list follower?

​How do I find who follows a specific Twitter list?

​How do I export Twitter list followers?

​What can I check in each Twitter profile?

​Can this API add, remove, or buy list followers?

​Direct list follower handoff

List follower audience

Next page

Default page

Saved export

​Measure Twitter list follower profiles

​Track list audience changes

​Path parameters

​Query parameters

​Which list endpoint?

List followers

List members

List tweets

Bulk list jobs

​User result filters

​Headers

​Response

​200 OK

​400 Invalid list ID

​401 Unauthenticated

​402 Payment required

​404 List not found

​502 X API unavailable

​429 Rate limit exceeded

​424 Dependency failed

Twitter list followers questions

What is a Twitter list follower?

How do I find who follows a specific Twitter list?

How do I export Twitter list followers?

What can I check in each Twitter profile?

Can this API add, remove, or buy list followers?

Direct list follower handoff

Measure Twitter list follower profiles

Track list audience changes

Path parameters

Query parameters

Which list endpoint?

User result filters

Headers

Response

200 OK

400 Invalid list ID

401 Unauthenticated

402 Payment required

404 List not found

502 X API unavailable

429 Rate limit exceeded

424 Dependency failed