> ## 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.
# Get list members
> Retrieve members of an X list with profile details and follower counts
For the complete documentation index, see llms.txt.
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](https://xquik.com/#pricing) from \$0.00012/credit
```bash cURL theme={null}
curl "https://xquik.com/api/v1/x/lists/1234567890/members" \
-H "x-api-key: xq_YOUR_KEY_HERE" | jq
```
```javascript Node.js theme={null}
const listId = "1234567890";
const response = await fetch(`https://xquik.com/api/v1/x/lists/${listId}/members`, {
headers: { "x-api-key": "xq_YOUR_KEY_HERE" },
});
const data = await response.json();
const memberRows = data.users.map((user) => ({
list_id: listId,
member_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;
```
```python Python theme={null}
import requests
list_id = "1234567890"
response = requests.get(
f"https://xquik.com/api/v1/x/lists/{list_id}/members",
headers={"x-api-key": "xq_YOUR_KEY_HERE"},
)
data = response.json()
member_rows = [
{
"list_id": list_id,
"member_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
```
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`](/api-reference/extractions/create) 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`.
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.
Set `pageSize` from 20 to 200. Treat the returned `users.length` as the row
count for the page.
Use `list_member_extractor` when the workflow needs a saved job with
CSV/JSON/XLSX output.
## Path parameters
List ID (numeric string).
## Query parameters
Pagination cursor from a previous response. Omit for the first page.
Results per page. Range: 20-200. Default: `20`.
## Which list endpoint?
Use `GET /x/lists/{id}/members` for accounts the list owner added to the
list.
Use [`GET /x/lists/{id}/followers`](/api-reference/x/list-followers) for
accounts that follow the list.
Use [`GET /x/lists/{id}/tweets`](/api-reference/x/list-tweets) for tweets
from accounts in the list.
Use [`Create extraction`](/api-reference/extractions/create) with
`list_member_extractor`, `list_follower_explorer`, or `list_post_extractor`
when the workflow needs a saved export.
## Headers
Your API key. Session cookie authentication is also supported.
## Response
Array of list members.
User ID.
X username.
Display name.
Profile bio.
Follower count.
Following count.
Verified status.
Profile image URL.
Profile location.
Account creation date (ISO 8601).
Total number of tweets posted. Omitted if unavailable.
Cover/banner image URL. Omitted if unavailable.
Total number of media tweets posted. Omitted if unavailable.
Whether the user accepts direct messages. Omitted if unavailable.
Website URL from profile. Omitted if empty.
Total number of tweets liked. Omitted if unavailable.
Whether the user has custom timelines. Omitted if unavailable.
Whether the user is an X translator. Omitted if unavailable.
Country codes where the account is withheld. Omitted if empty.
Whether the account is flagged as possibly sensitive. Omitted if unavailable.
IDs of pinned tweets. Omitted if none.
Whether the account is marked as automated. Omitted if unavailable.
Username of the account operator if automated. Omitted if not automated.
Whether the account is unavailable. Omitted if available.
Reason the account is unavailable. Omitted if available.
Verification type (e.g. `Business`, `Government`). Omitted if not verified or standard blue check.
Structured profile bio with entity annotations. Omitted if unavailable.
Whether more results are available.
Cursor for the next page. Pass as the `cursor` query parameter.
```json theme={null}
{
"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..."
}
```
```json theme={null}
{ "error": "invalid_list_id", "message": "List ID required" }
```
The list ID path parameter is empty.
```json theme={null}
{ "error": "unauthenticated" }
```
Missing or invalid API key.
```json theme={null}
{ "error": "no_subscription" }
```
No active subscription or insufficient credits. Possible error values: `no_subscription`, `subscription_inactive`, `no_credits`, `insufficient_credits`.
For [MPP](/mpp/overview) requests without a valid payment credential, 402 returns a `WWW-Authenticate: Payment` challenge header instead.
```json theme={null}
{ "error": "not_found" }
```
The list could not be resolved. Check the list ID.
```json theme={null}
{ "error": "x_api_unavailable" }
```
The read service returned an error. Retry after a short delay.
```json theme={null}
{ "error": "rate_limit_exceeded", "retryAfter": 60 }
```
Your tier rate limit was exceeded. Wait for the `Retry-After` header before retrying.
```json theme={null}
{ "error": "x_api_unavailable" }
```
The normalized v1 response contract can return 424 when the read service is unavailable.
**Related:** [List Followers](/api-reference/x/list-followers) · [List Tweets](/api-reference/x/list-tweets)