Skip to main content
POST
Twitter List Members API

Twitter List Members

Export the accounts someone has added to a public X list. Each member comes back as a full profile with bio, location, website, verification status and follower, following and post counts. Lists are hand-picked, so their members are often a strong seed for prospecting: a “fintech founders” or “AI researchers” list curated by someone in the field is a shortlist you can enrich, score and reach out to without searching from scratch.
Provide public X list URLs in urls, using /i/lists/. results_limit applies to each list, defaults to 100, and must be a multiple of 20 between 20 and 2000.

Standard Result Fields

Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, use fields for MCP queries, _result_fields for typed tools, or --result-fields in the CLI. Declared fields remain present when their value is null. The following example shows the response format for a completed task. Actual data depends on your query.

Completed Task Response

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Provide public X list URLs in urls, using /i/lists/{numeric_id}. results_limit applies to each list, defaults to 100, and must be a multiple of 20 between 20 and 2000.

urls
string[]
required

Public profile or content URLs.

Minimum array length: 1
Minimum string length: 1
callback_url
string<uri>
results_limit
integer
default:100
Required range: 20 <= x <= 2000Must be a multiple of 20

Response

Task accepted

code
integer
data
object