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
| Parameters | Required | Description |
|---|---|---|
urls | Required | Public 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_limit | Optional | Maximum 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.
- 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.
- Check GET /v1/tasks/{task_id} every few seconds until the status reads succeeded.
- 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.
Related APIs
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.
- Twitter Tweet Scraper API
- Twitter User Tweets Scraper API
- Twitter Search API
- X Post Quotes API
- X Post Replies API
- X Trends API
- Twitter Mentions API
- Twitter User Search API
- X Community API
- X Community Posts API
- X Thread Context API
- X Verified Followers API
- Twitter List Followers API
- X Community Members API
- X Community Moderators API
- X Communities Search API
- X Articles API
- X Spaces API
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API