Skip to main content
GET
/
x
/
lists
/
{id}
/
followers
Get list followers
curl --request GET \
  --url https://xquik.com/api/v1/x/lists/{id}/followers \
  --header 'x-api-key: <api-key>'

Documentation Index

Fetch the complete documentation index at: https://docs.xquik.com/llms.txt

Use this file to discover all available pages before exploring further.

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_KEY_HERE" | jq
The Node.js and Python snippets shape durable list-follower rows instead of printing full profile pages. Persist followerRows or follower_rows with nextCursor before requesting the next page.

Direct list follower handoff

Use GET /x/lists/{id}/followers when a CRM, warehouse, audience, enrichment, or agent workflow needs one JSON page of accounts that follow a list. Use list_follower_explorer when you need a saved extraction, estimated job, or CSV/JSON/XLSX file export. Store list_id, follower_id, username, display_name, profile metrics, verification state, has_next_page, and next_cursor. Treat next_cursor as opaque and pass it back as cursor only when has_next_page is true. Direct calls return the default paid page size and cost 1 credit per user returned. Zero affordable results return 402 insufficient_credits.

Path parameters

id
string
required
List ID (numeric string).

Query parameters

cursor
string
Pagination cursor from a previous response. Omit for the first page.

Headers

x-api-key
string
required
Your API key. Session cookie authentication is also supported.

Response

users
object[]
Array of list followers.
has_next_page
boolean
Whether more results are available.
next_cursor
string
Cursor for the next page. Pass as the cursor query parameter.
{
  "users": [
    {
      "id": "987654321",
      "username": "xquikcom",
      "name": "Xquik",
      "followers": 10000,
      "verified": true
    }
  ],
  "has_next_page": true,
  "next_cursor": "DAACCgACGE..."
}
Last modified on May 17, 2026