GET https://xquik.com/api/v1/x/lists/{id}
1 credit per call · All plans from $0.00012/credit
One public List
UseGET /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.Related. List members · List tweets · Search lists
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." }