Twitter user lists API: lists an account created

{
  "lists": [],
  "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": "x_account_protected",
  "message": "Account is protected. Choose a public account."
}

{
  "error": "user_not_found",
  "message": "X user not found. Check the username."
}

{
  "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": "Xquik is busy right now. Retry shortly."
}

GET

users

{id}

lists

Twitter user lists API: lists an account created

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

package main

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

func main() {

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

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

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

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

	fmt.Println(string(body))

}

{
  "lists": [
    {
      "id": "<string>",
      "name": "<string>",
      "description": "<string>",
      "memberCount": 123,
      "subscriberCount": 123,
      "owner": {},
      "url": "<string>",
      "createdAt": "<string>",
      "bannerUrl": "<string>",
      "customBanner": {},
      "defaultBanner": {},
      "facepileUrls": [
        "<string>"
      ],
      "membersContext": "<string>"
    }
  ],
  "has_next_page": true,
  "next_cursor": "<string>"
}

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

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

const username = "verge";
const response = await fetch(`https://xquik.com/api/v1/x/users/${username}/lists`, {
  headers: { "x-api-key": "xq_your_api_key_here" },
});
const data = await response.json();
if (!response.ok) throw new Error(JSON.stringify(data));
const nextCursor = data.has_next_page ? data.next_cursor : null;
const listRows = data.lists.map((list) => ({
  profile_username: username,
  list_id: list.id,
  list_name: list.name,
  member_count: list.memberCount ?? null,
  follower_count: list.subscriberCount ?? null,
  owner_username: list.owner?.username ?? null,
  list_url: list.url ?? null,
  next_cursor: nextCursor,
}));

import requests

username = "verge"
response = requests.get(
    f"https://xquik.com/api/v1/x/users/{username}/lists",
    headers={"x-api-key": "xq_your_api_key_here"},
)
data = response.json()
if not response.ok:
    raise RuntimeError(data)
next_cursor = data["next_cursor"] if data["has_next_page"] else None
list_rows = [
    {
        "profile_username": username,
        "list_id": item["id"],
        "list_name": item["name"],
        "member_count": item.get("memberCount"),
        "follower_count": item.get("subscriberCount"),
        "owner_username": (item.get("owner") or {}).get("username"),
        "list_url": item.get("url"),
        "next_cursor": next_cursor,
    }
    for item in data["lists"]
]

The Node.js and Python snippets build 1 row per List. Store listRows or list_rows with nextCursor or next_cursor before requesting the next page.

Read the Lists an account created

Use GET /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

string

required

User ID, username with or without @, or URL-encoded profile URL, such as x.com/verge. See path IDs.

Query parameters

string

Pagination cursor. Pass the next_cursor value from the previous response to fetch the next page.

integer

Lists per page. Range: 1-100. Defaults to 20. Aliases: limit, count, max_results, maxItems, max_items & per_page.

Headers

string

Full account key. Sessions and OAuth also work.

string

Bearer xq_your_guest_key_here for paid_reads.

Response

200 OK

object[]

Public Lists the account created, in X’s order. List object fields.

string

Numeric List ID.

string

List name.

string

List description. Empty when the owner wrote none.

number

Accounts on the List.

number

Accounts that follow the List.

object

Public profile of the account that owns the List, with the fields of Get User.

string

List page on x.com.

string

When the owner made the List (ISO 8601).

string

URL of the banner the owner uploaded. Omitted when the owner uploaded none.

object

Banner the owner uploaded: url, width, height, salientRect, mediaId, mediaKey & dominant colors in palette. Omitted when there is none.

object

Banner X shows when the owner uploaded none: url, width, height & salientRect. X picks it per reading account, so 2 calls can return different ones.

string[]

Avatar URLs of a few List members, which X may pick per request.

string

Member count as X words it, such as 35 members.

boolean

Whether more results are available.

string

Cursor for the next page.

{
  "lists": [
    {
      "id": "1284239399492833280",
      "name": "#Mars2020 Science & Tech",
      "description": "Official accounts on the Perseverance Mars rover mission.",
      "memberCount": 35,
      "subscriberCount": 76,
      "owner": {
        "id": "1232783237623119872",
        "username": "NASAPersevere",
        "name": "NASA's Perseverance Mars Rover",
        "followers": 2887286,
        "verified": true
      },
      "url": "https://x.com/i/lists/1284239399492833280",
      "createdAt": "2020-07-17T21:31:47.000Z",
      "membersContext": "35 members"
    }
  ],
  "has_next_page": true,
  "next_cursor": "DAAHCgABHTwHK3H..."
}

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 get WWW-Authenticate: Bearer and a guest wallet checkout action. This is not a Payment challenge.

{ "error": "unauthenticated" }

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.

404 User not found

{ "error": "user_not_found", "message": "X user not found. Check the username." }

502 X API unavailable

{ "error": "x_api_unavailable" }

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

503 Service busy

{ "error": "x_api_unavailable" }

Xquik is busy. Wait for Retry-After, then retry.

429 Rate limit exceeded

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

The Xquik tier limit blocked the request. Use Retry-After when present. Otherwise, use the JSON retryAfter field.

424 Dependency failed

{ "error": "x_api_unavailable" }

The opt-in normalized contract returns 424 when the read service fails. Send xquik-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?

Call GET /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. Lower pageSize 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.

{
  "lists": [],
  "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": "x_account_protected",
  "message": "Account is protected. Choose a public account."
}

{
  "error": "user_not_found",
  "message": "X user not found. Check the username."
}

{
  "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": "Xquik is busy right now. Retry shortly."
}

Twitter user lists API: lists an account created

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

package main

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

func main() {

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

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

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

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

	fmt.Println(string(body))

}

{
  "lists": [
    {
      "id": "<string>",
      "name": "<string>",
      "description": "<string>",
      "memberCount": 123,
      "subscriberCount": 123,
      "owner": {},
      "url": "<string>",
      "createdAt": "<string>",
      "bannerUrl": "<string>",
      "customBanner": {},
      "defaultBanner": {},
      "facepileUrls": [
        "<string>"
      ],
      "membersContext": "<string>"
    }
  ],
  "has_next_page": true,
  "next_cursor": "<string>"
}

​Read the Lists an account created

​Path parameters

​Query parameters

​Headers

​Response

​200 OK

​400 Invalid user ID

​401 Unauthenticated

​402 Payment required

​403 Protected account

​404 User not found

​502 X API unavailable

​503 Service busy

​429 Rate limit exceeded

​424 Dependency failed

​Twitter user Lists questions

​How do I get the Lists a Twitter account created?

​How much does it cost?

​Does it return private Lists?

​How do I see the Lists an account is on?

​Does this replace X’s official API?

Read the Lists an account created

Path parameters

Query parameters

Headers

Response

200 OK

400 Invalid user ID

401 Unauthenticated

402 Payment required

403 Protected account

404 User not found

502 X API unavailable

503 Service busy

429 Rate limit exceeded

424 Dependency failed

Twitter user Lists questions

How do I get the Lists a Twitter account created?

How much does it cost?

Does it return private Lists?

How do I see the Lists an account is on?

Does this replace X’s official API?