GET https://xquik.com/api/v1/x/users/{id}/lists
Requested result counts are upper bounds for paid authenticated calls. When remaining credits cannot cover the full page, Xquik returns fewer results. If zero paid results are affordable, it returns
402 insufficient_credits.1 credit per List returned · All plans from $0.00012/credit
listRows or
list_rows with nextCursor or next_cursor before requesting the next page.
Read the Lists an account created
UseGET /x/users/{id}/lists to read the public Lists 1 account created. The
Lists come in X’s order, as the profile’s Lists tab shows them.
Each List carries the id that List members,
List followers and
List tweets take. Store the id, since a List
name can change.
A private List stays out of every answer. An empty lists array with
has_next_page: false means the account has no more public Lists. It costs
nothing. Use List memberships for the
Lists that include the account.Path parameters
Query parameters
Choose fields
Headers
Response
200 OK
400 Invalid user ID
{ "error": "invalid_user_id", "message": "Send a user ID, @username or profile URL, such as x.com/nasa." }
The user ID is empty or invalid.401 Unauthenticated
Anonymous requests getWWW-Authenticate: Bearer and a guest wallet checkout action. This is not a Payment challenge.402 Payment required
Account keys get account options. Guest keys get guest top-up only. No checkout starts automatically. Confirm any payment action.403 Protected account
{ "error": "x_account_protected", "message": "Account is protected. Choose a public account." }
The account is protected, so X shows its Lists to no one else. The request costs nothing.502 X API unavailable
The read service returned an error. Retry after a short delay.503 Service busy
Xquik is busy. Wait forRetry-After, then retry.429 Rate limit exceeded
The Xquik tier limit blocked the request. UseRetry-After when present. Otherwise, use the JSON retryAfter field.424 Dependency failed
The opt-in normalized contract returns 424 when the read service fails. Sendxquik-api-contract: 2026-04-29 to opt in. Default v1 returns 502.Twitter user Lists questions
How do I get the Lists a Twitter account created?
CallGET /x/users/{id}/lists with the user ID, username, or profile URL. Each
result is a public List the account created.How much does it cost?
Each returned List costs 1 credit. An empty page costs nothing. LowerpageSize to return fewer Lists.Does it return private Lists?
No. It returns only public Lists. Private Lists stay out of every answer.How do I see the Lists an account is on?
Use List memberships. It returns the public Lists that include the account.Does this replace X’s official API?
No. This page documents Xquik, an independent third-party service. It does not document X’s official API.Next steps. List members reads who is on a List, and List tweets reads its timeline.
Response examples
- 400
{ "error": "invalid_input", "message": "Invalid input. Check the request body." } - 401
{ "error": "unauthenticated", "message": "Authentication required." } - 402
{ "error": "insufficient_credits", "message": "Insufficient credits. Top up or subscribe to continue." } - 403
{ "error": "api_key_paused", "message": "This API key is paused. Resume it at dashboard.xquik.com/api-keys to use it again." } - 404
{ "error": "user_not_found", "message": "X user not found. Check the username." } - 424
{ "error": "x_api_unavailable", "message": "X data source temporarily unavailable. Try again later." } - 429
{ "error": "rate_limit_exceeded", "message": "Too many requests. Try again later.", "retryAfter": 60 } - 502
{ "error": "x_api_unavailable", "message": "X data source temporarily unavailable. Try again later." } - 503
{ "error": "x_api_unavailable", "message": "Xquik is busy right now. Retry shortly." }