Skip to main content
GET https://xquik.com/api/v1/x/lists/{id}
1 credit per call · All plans from $0.00012/credit

One public List

Use GET /x/lists/{id} for one public X List as its page on X shows it. You get its name, description, member and follower counts, owner, banner, and creation time. Name the List by its ID or its URL-encoded URL, such as x.com/i/lists/4143408. A private List returns 404 list_not_found, since only its members see it on X. For the List’s people or posts, use List members, List followers, or List tweets.

Path parameters

Query parameters

Headers

Response

200 OK

404 List not found

{ "error": "list_not_found" } The List is private, deleted, or never existed.

401 Unauthenticated

Missing or invalid API key.

402 Payment required

Account keys get account options. Guest keys get guest top-up only. No checkout starts automatically. Confirm any payment action.

502 X API unavailable

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

Response examples

200 example

  • 400 { "error": "invalid_input", "message": "Invalid input. Check the request body." }
  • 401 { "error": "unauthenticated", "message": "Authentication required. Provide a valid API key or bearer token." }
  • 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": "not_found", "message": "Resource not found." }
  • 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." }