x/
list-followers

The Twitter List Followers API shows who subscribes to public X lists: submit a list URL and get each follower's bio, location, verified flag, join date and follower, following and post counts.

Twitter List Followers API

List URL input
List subscribers
Up to 2,000 per list
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 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

ParametersRequiredDescription
urlsRequiredOne 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_limitOptionalFollowers 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.

  1. Send {"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 100} as a POST to /v1/x/list-followers and keep the task_id.
  2. Call GET /v1/tasks/{task_id} on an interval until status turns succeeded.
  3. 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.

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.

Explore other platforms

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

Twitter List Followers API — FAQ

Twitter List Followers API is a programmatic interface for collecting the accounts that follow, or subscribe to, public X lists, using each list's URL. It returns every follower's username, name, bio, location, website, verified and private flags, join date and follower, following and post counts.

Yes, for public lists. Submit the list URL and each subscriber comes back as a profile row, up to 2,000 per list.

Followers subscribed to a list to read its timeline; members are the accounts the list's owner added. The Twitter List Followers API returns followers, and Twitter List Members API returns members.

No. It returns the subscribers of a list. For the accounts following a user profile, use X Followers List API.

Small lists often have only a few subscribers, and the result holds exactly the accounts that follow the list. The Twitter List Followers API charges 0.7 credits for each follower returned, and an empty result costs nothing.