Get list members

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/members" \
  -H "x-api-key: xq_YOUR_KEY_HERE" | jq

The Node.js and Python snippets shape durable list-member rows instead of printing full profile pages. Persist memberRows or member_rows with nextCursor before requesting the next page.

Direct list member handoff

Use GET /x/lists/{id}/members when a CRM, warehouse, audience, enrichment, or agent workflow needs one JSON page of accounts on a list. Use list_member_extractor when you need a saved extraction, estimated job, or CSV/JSON/XLSX file export. Store list_id, member_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. Set pageSize from 20 to 200 for direct calls. Zero affordable results return 402 insufficient_credits.

Member roster

Page accounts the list owner curated as members. Use 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.

Page size

Set pageSize from 20 to 200. Treat the returned users.length as the row count for the page.

Saved export

Use list_member_extractor when the workflow needs a saved job with CSV/JSON/XLSX output.

Path parameters

string

required

List ID (numeric string).

Query parameters

cursor

string

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

pageSize

number

Results per page. Range: 20-200. Default: 20.

Which list endpoint?

List members

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

List followers

Use GET /x/lists/{id}/followers for accounts that follow 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_member_extractor, list_follower_explorer, or list_post_extractor when the workflow needs a saved export.

Headers

x-api-key

string

required

Your API key. Session cookie authentication is also supported.

Response

users

object[]

Array of list members.

Show User object fields

string

User ID.

username

string

X username.

name

string

Display name.

description

string

Profile bio.

followers

number

Follower count.

following

number

Following count.

verified

boolean

Verified status.

profilePicture

string

Profile image URL.

location

string

Profile location.

createdAt

string

Account creation date (ISO 8601).

statusesCount

number

Total number of tweets posted. Omitted if unavailable.

coverPicture

string

Cover/banner image URL. Omitted if unavailable.

mediaCount

number

Total number of media tweets posted. Omitted if unavailable.

canDm

boolean

Whether the user accepts direct messages. Omitted if unavailable.

url

string

Website URL from profile. Omitted if empty.

favouritesCount

number

Total number of tweets liked. Omitted if unavailable.

hasCustomTimelines

boolean

Whether the user has custom timelines. Omitted if unavailable.

isTranslator

boolean

Whether the user is an X translator. Omitted if unavailable.

withheldInCountries

string[]

Country codes where the account is withheld. Omitted if empty.

possiblySensitive

boolean

Whether the account is flagged as possibly sensitive. Omitted if unavailable.

pinnedTweetIds

string[]

IDs of pinned tweets. Omitted if none.

isAutomated

boolean

Whether the account is marked as automated. Omitted if unavailable.

automatedBy

string

Username of the account operator if automated. Omitted if not automated.

unavailable

boolean

Whether the account is unavailable. Omitted if available.

unavailableReason

string

Reason the account is unavailable. Omitted if available.

verifiedType

string

Verification type (e.g. Business, Government). Omitted if not verified or standard blue check.

profile_bio

object

Structured profile bio with entity annotations. Omitted if unavailable.

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,
      "profilePicture": "https://pbs.twimg.com/profile_images/xquik/photo.jpg"
    }
  ],
  "has_next_page": true,
  "next_cursor": "DAACCgACGE..."
}

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

The list ID path parameter is empty.

{ "error": "unauthenticated" }

Missing or invalid API key.

{ "error": "no_subscription" }

No active subscription or insufficient credits. Possible error values: no_subscription, subscription_inactive, no_credits, insufficient_credits. For MPP requests without a valid payment credential, 402 returns a WWW-Authenticate: Payment challenge header instead.

{ "error": "not_found" }

The list could not be resolved. Check the list ID.

{ "error": "x_api_unavailable" }

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

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

Your tier rate limit was exceeded. Wait for the Retry-After header before retrying.

{ "error": "x_api_unavailable" }

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

Related: List Followers · List Tweets

Documentation Index

​Direct list member handoff

Member roster

Next page

Page size

Saved export

​Path parameters

​Query parameters

​Which list endpoint?

List members

List followers

List tweets

Bulk list jobs

​Headers

​Response

Direct list member handoff

Path parameters

Query parameters

Which list endpoint?

Headers

Response