x/
list-members

The Twitter List Members API exports the accounts on public X lists from their list URLs, with each member's username, bio, location, website, verification and follower, following and post counts.

Twitter List Members API

List URL input
Owner-added accounts
Full member profiles
0.7 credits / result
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

By SocQ · Updated

Twitter List Members

Twitter list members are the accounts an X list's owner has picked and added by hand, and each one carries a public profile with name, bio, location, website, verification, join date and follower, following and post counts. Because someone in the field has already done the selecting, these profiles make a ready shortlist for prospecting, influencer research and account enrichment, and repeated snapshots record how a curated group changes.

Twitter List Members API Features

  • Owner-picked accounts from a list URLEach x.com/i/lists/<id> URL you submit to the Twitter List Members API returns the accounts its owner placed on the list, up to 2,000 per list, turning a hand-curated group into rows you can sort and filter.
  • A full profile for every memberRows carry username, display name, the bio in text, avatar and cover images, website and location.name, enough to judge whether an account fits right from the row.
  • Reach, activity and account agemetrics.followers_count, following_count and posts_count show each member's audience and output, and published_at gives the date the account joined X.
  • Verification and privacy flagsis_verified and is_private mark verified members and protected accounts, so each group can be handled on its own.

Twitter List Members API Parameters

ParametersRequiredDescription
urlsRequiredPublic X list URLs ending in /i/lists/<numeric id>, for example https://x.com/i/lists/1940592907737845989. Members of each list are returned separately.
results_limitOptionalMaximum members to export from each list, in steps of 20 from 20 to 2,000. Defaults to 100.

How to Use the Twitter List Members API

Submit the list URLs you want exported to the Twitter List Members API and collect the member profiles once the task is done.

  1. Copy each list's URL from x.com and POST {"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 100} to /v1/x/list-members.
  2. Check GET /v1/tasks/{task_id} every few seconds until the status reads succeeded.
  3. Save the member profiles in results.items; while has_more is true, request the next page with results.next_cursor.
curl -X POST "https://api.socq.ai/v1/x/list-members" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://x.com/i/lists/1940592907737845989"],"results_limit":100}'

# Each member's bio is in text and the date the account joined X is in published_at.

Twitter List Members API Use Cases

  • Turning a curated list into a prospect shortlist: Export a list such as fintech founders or AI researchers, then keep the members whose bio text and website match your offer before reaching out.
  • Ranking and tiering a niche's accounts: Sort members by metrics.followers_count and split them by is_verified or location.name to separate the biggest voices and regional groups.
  • Enriching CRM and lead records: Add username, website, location.name and bio to contact records, matched on each member's account id.
  • Recording how a list changes: Export the same list with the Twitter List Members API on a schedule and compare member ids between runs to see who was added or removed.

Twitter List Members API Pro Tips

  • Match members across Twitter List Members API exports on id, because usernames can be changed.
  • Read location.name for where a member says they are; city, region and country can be null even when a place is shown, so parse location.name yourself before grouping by country.
  • Set results_limit to the next multiple of 20 above the list's member count to export the whole list in one task; only the members returned are charged.
  • Submit the same list URL to X List Tweets API to read what these members post, and to Twitter List Followers API to see who reads the list.

Beyond the Twitter List Members API, use these APIs when you need a different type of public X data.

  • Twitter Profile Scraper API — Retrieve public account identity, biographies, avatars, cover images, account status, and visible audience statistics by username.
  • X Followers List API — Collect public follower account identities and visible profile metrics for one or more X usernames.
  • X Following List API — Collect profiles followed by public X accounts, including identity, biographies, account signals, visible counters, and source usernames.
  • X Post Retweeters API — Collect a task-level unique set of normalized public profiles for accounts that reposted known X or Twitter status URLs.
  • X Account Location API — Look up the country an account is based in, how it connects to X, its join date and username changes.
  • X List Tweets API — Read a list's timeline, newest first, with reposts flagged and their original authors.

Explore other platforms

Combine X data with public data from other supported social platforms.

Twitter List Members API — FAQ

Twitter List Members API is a programmatic interface for exporting the accounts that belong to public X lists, using each list's URL. It returns a profile for every member with username, name, bio, location, website, verified and private flags, join date and follower, following and post counts.

Copy the list's URL from x.com, submit it in urls with a results_limit, and read the member profiles from the finished task, following next_cursor while has_more is true. Each member is a JSON record you can write to a spreadsheet or CRM.

Yes. Any public list can be exported from its URL, whoever created it.

Up to 2,000 per list, set with results_limit in steps of 20; the default is 100. When you submit several lists, the limit applies to each one.

The Twitter List Members API charges 0.7 credits for each member returned, so a 100-member list costs 70 credits. An empty result costs nothing.