Twitter List Followers
Twitter list followers are the accounts that subscribed to an X list to read its members' tweets, and each one has a public profile with bio, location, verification, join date and follower, following and post counts. Following a list is a choice to keep up with its topic, so these profiles show who a niche attracts, let you compare the readers of related lists and point to people worth approaching about that subject.
Twitter List Followers API Features
- Subscribers of any public listSubmit x.com/i/lists/<id> links to the Twitter List Followers API and get the accounts that chose to follow each list's timeline, up to 2,000 per list.
- Who each follower isEvery row has username, display name, the bio in text, avatar, cover image, website and location.name, which together show what kind of people a list draws.
- Reach, activity, tenure and verificationmetrics.followers_count, following_count and posts_count, published_at as the join date and is_verified help separate established, active followers from new or low-activity accounts.
Twitter List Followers API Parameters
| Parameters | Required | Description |
|---|---|---|
urls | Required | One or more public X list URLs, each in the form https://x.com/i/lists/<numeric id>. Followers are collected for every list you include. |
results_limit | Optional | Followers to collect per list: a multiple of 20 between 20 and 2,000, with 100 by default. |
How to Use the Twitter List Followers API
Start a Twitter List Followers API task with one or more list URLs, then page through the accounts that follow each list.
- Send {"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 100} as a POST to /v1/x/list-followers and keep the task_id.
- Call GET /v1/tasks/{task_id} on an interval until status turns succeeded.
- Collect followers from results.items, passing results.next_cursor on the next call for as long as has_more is true.
curl -X POST "https://api.socq.ai/v1/x/list-followers" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://x.com/i/lists/1940592907737845989"],"results_limit":100}'
# Every item is an account that follows the list; the list's members come from /v1/x/list-members.Twitter List Followers API Use Cases
- Seeing who follows your own list: Collect the followers of a public list you curate to learn who reads it and which readers have the largest audiences by followers_count.
- Profiling the audience of a topic: Read the bios and location.name of the people following a climate tech or SaaS founders list to describe who is interested in that subject.
- Shortlisting people to contact: Filter followers by keywords in text and by followers_count to pick accounts that already read about your field.
- Comparing the readers of rival lists: Collect followers from two lists on the same subject in one Twitter List Followers API task and match on id to find shared readers and the ones unique to each list.
- Seeding a lookalike audience: Export the usernames and ids of a well-chosen list's followers as a seed set for lookalike or interest targeting in your ad tools.
Twitter List Followers API Pro Tips
- Match followers with the list's members from Twitter List Members API on id to find members who also follow the list and readers who sit outside it.
- Use the same results_limit for every list you compare, so each audience is collected to the same depth.
- Store follower ids from each run; a later export of the same list then shows who started following it in between.
Related APIs
Beyond the Twitter List Followers 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 List Tweets API — Read a list's timeline, newest first, with reposts flagged and their original authors.
- Twitter List Members API — Export the accounts on a list as full profiles with bios, locations and counts.
- 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 Account Location API
- X Verified 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