GET https://xquik.com/api/v1/x/lists/search
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.
Find Lists before you read them
UseGET /x/lists/search when you know a topic but not a List ID. It returns
the public Lists X finds for your keywords, in X’s order. X may rank the Lists
differently per request. Each List carries the
id that List members,
List followers and
List tweets take.
Compare memberCount, subscriberCount and the owner profile to pick a List.
A List with many followers is often a well-kept source. Store the List id,
since a List name can change.
An empty lists with has_next_page: false means X has no more Lists
for your keywords. It costs nothing.Query parameters
Choose fields
Headers
Response
200 OK
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.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.X (Twitter) List search questions
How do I search X (Twitter) Lists by keyword?
CallGET /x/lists/search with your keywords in q. Each result is a public
List with its ID, counts and owner.How much does a List search cost?
Each returned List costs 1 credit. An empty page costs nothing. LowerpageSize to return fewer Lists.Does List search return private Lists?
No. It returns only public Lists. Private Lists stay out of every answer.Why do 2 searches return Lists in another order?
X may rank the Lists differently per request. Store each Listid and dedupe
by it when you merge pages or runs.How do I get the members of a List I found?
Pass the Listid to List members. Use
List tweets for its timeline.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": "missing_query", "message": "Search query required. Use q." } - 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." } - 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." }