Lists & Communities

Use the Sorsa API to retrieve members, followers, and tweet feeds from public X Lists. This page also describes the Community request formats listed in the API Reference; see the availability note before using them in a new workflow.

Note: For strategic context, cost math, and end-to-end monitoring workflows, see the X List API guide on the blog.

Community availability: The API Reference lists Community endpoints, but their current data availability needs confirmation. Before building a new Community workflow, contact support to confirm which operations and results are available. The request examples below document the interface; they are not a live availability test.

Lists

An X List is a public collection of up to 5,000 accounts. Lists have two audiences:

Members: accounts added to the list by the curator.
Followers (subscribers): users who subscribed to read the List timeline.

Private Lists are not API-accessible.

Endpoint	Method	Returns	Page size
`/v3/list-members`	GET	User profiles of accounts in the list	up to 200
`/v3/list-followers`	GET	User profiles of accounts following the list	up to 200
`/v3/list-tweets`	GET	Combined chronological feed from list members	~20

The List ID is the numeric value in the list URL: https://x.com/i/lists/1234567890 means the ID is 1234567890.

Tip: Every account starts with 100 free requests (no card, no expiry), enough to pull a mid-sized List end to end. Test any endpoint without writing code in the API Playground.

Get List Members

GET /v3/list-members

Parameter	Type	Required	Description
`list_id`	string	Yes	Numeric List ID.
`next_cursor`	string	No	Pagination cursor from a previous response.

curl "https://api.sorsa.io/v3/list-members?list_id=1234567890" \
  -H "ApiKey: YOUR_API_KEY"

import requests

API_KEY = "YOUR_API_KEY"
BASE = "https://api.sorsa.io/v3"
HEADERS = {"ApiKey": API_KEY}


def get_list_members(list_id, max_pages=50):
    members, cursor = [], None

    for _ in range(max_pages):
        params = {"list_id": list_id}
        if cursor:
            params["next_cursor"] = cursor

        r = requests.get(f"{BASE}/list-members", headers=HEADERS, params=params, timeout=30)
        r.raise_for_status()
        data = r.json()

        members.extend(data.get("users", []))
        cursor = data.get("next_cursor")
        if not cursor:
            break

    return members


members = get_list_members("1234567890")
for u in members[:5]:
    print(f"@{u['username']} ({u['followers_count']:,} followers)")

A full 5,000-member List takes ~25 requests to extract.

Get List Followers

GET /v3/list-followers

Parameter	Type	Required	Description
`list_link`	string	Yes	List URL or numeric ID.
`next_cursor`	string	No	Pagination cursor.

Note the parameter name: /list-followers takes list_link (URL or ID), while /list-members and /list-tweets take list_id (numeric ID only).

def get_list_followers(list_link, max_pages=50):
    followers, cursor = [], None

    for _ in range(max_pages):
        params = {"list_link": list_link}
        if cursor:
            params["next_cursor"] = cursor

        r = requests.get(f"{BASE}/list-followers", headers=HEADERS, params=params, timeout=30)
        r.raise_for_status()
        data = r.json()

        followers.extend(data.get("users", []))
        cursor = data.get("next_cursor")
        if not cursor:
            break

    return followers


subs = get_list_followers("https://x.com/i/lists/1234567890")
print(f"{len(subs)} subscribers")

Get List Tweets

GET /v3/list-tweets Returns recent tweets from all list members in a single chronological feed. This is the endpoint used in the Real-Time Monitoring workflow for tracking groups of accounts with a single request instead of polling each account separately.

Parameter	Type	Required	Description
`list_id`	string	Yes	Numeric List ID.
`next_cursor`	string	No	Pagination cursor.

def get_list_tweets(list_id, max_pages=10):
    tweets, cursor = [], None

    for _ in range(max_pages):
        params = {"list_id": list_id}
        if cursor:
            params["next_cursor"] = cursor

        r = requests.get(f"{BASE}/list-tweets", headers=HEADERS, params=params, timeout=30)
        r.raise_for_status()
        data = r.json()

        tweets.extend(data.get("tweets", []))
        cursor = data.get("next_cursor")
        if not cursor:
            break

    return tweets


feed = get_list_tweets("1234567890", max_pages=10)
for t in feed[:5]:
    print(f"@{t['user']['username']}: {t['full_text'][:80]}")

Communities

The following request formats describe the Community endpoints in the API Reference. Confirm availability as noted above before relying on them. Community membership can be an audience-discovery signal when member data is available. It does not by itself establish recent activity.

Endpoint	Method	Returns	Page size
`/v3/community-members`	POST	Community member profiles	~20
`/v3/community-tweets`	POST	Tweets posted inside the community	~20
`/v3/community-search-tweets`	POST	Keyword search inside the community	~20

The Community ID is the numeric value in the community URL: https://x.com/i/communities/1966045657589813686 means the ID is 1966045657589813686. Private Communities were not API-accessible.

Get Community Members

POST /v3/community-members

Parameter	Type	Required	Description
`community_link`	string	Yes	Community ID or full URL.
`next_cursor`	string	No	Pagination cursor.

Returns compact member profiles (id, username, display name, avatar, verified, and protected status).

def get_community_members(community_link, max_pages=20):
    members, cursor = [], None

    for _ in range(max_pages):
        body = {"community_link": community_link}
        if cursor:
            body["next_cursor"] = cursor

        r = requests.post(
            f"{BASE}/community-members",
            headers={**HEADERS, "Content-Type": "application/json"},
            json=body,
            timeout=30,
        )
        r.raise_for_status()
        data = r.json()

        members.extend(data.get("users", []))
        cursor = data.get("next_cursor")
        if not cursor:
            break

    return members

Get Community Tweets

POST /v3/community-tweets

Parameter	Type	Required	Description
`community_id`	string	Yes	Numeric Community ID.
`order`	string	No	`"latest"` (default) or `"popular"`.
`next_cursor`	string	No	Pagination cursor.

def get_community_tweets(community_id, order="latest", max_pages=10):
    tweets, cursor = [], None

    for _ in range(max_pages):
        body = {"community_id": community_id, "order": order}
        if cursor:
            body["next_cursor"] = cursor

        r = requests.post(
            f"{BASE}/community-tweets",
            headers={**HEADERS, "Content-Type": "application/json"},
            json=body,
            timeout=30,
        )
        r.raise_for_status()
        data = r.json()

        tweets.extend(data.get("tweets", []))
        cursor = data.get("next_cursor")
        if not cursor:
            break

    return tweets

Search Community Tweets

POST /v3/community-search-tweets

Parameter	Type	Required	Description
`community_link`	string	Yes	Community ID or full URL.
`query`	string	No	Search keyword. Omit to return the full community feed.
`order`	string	No	`"popular"` or `"latest"`.
`next_cursor`	string	No	Pagination cursor.

def search_community_tweets(community_link, query, order="popular", max_pages=5):
    tweets, cursor = [], None

    for _ in range(max_pages):
        body = {"community_link": community_link, "query": query, "order": order}
        if cursor:
            body["next_cursor"] = cursor

        r = requests.post(
            f"{BASE}/community-search-tweets",
            headers={**HEADERS, "Content-Type": "application/json"},
            json=body,
            timeout=30,
        )
        r.raise_for_status()
        data = r.json()

        tweets.extend(data.get("tweets", []))
        cursor = data.get("next_cursor")
        if not cursor:
            break

    return tweets

For one-off membership checks (without paginating the full member list), use the dedicated /check-community-member endpoint instead.

Exporting to CSV

User and tweet feeds from the Lists endpoints above can be exported with a single helper. For users:

import csv

def export_users_to_csv(users, path):
    fields = ["id", "username", "display_name", "description",
              "followers_count", "tweets_count", "verified", "location"]

    with open(path, "w", newline="", encoding="utf-8") as f:
        writer = csv.DictWriter(f, fieldnames=fields)
        writer.writeheader()
        for u in users:
            writer.writerow({
                "id": u.get("id", ""),
                "username": u.get("username", ""),
                "display_name": u.get("display_name", ""),
                "description": (u.get("description") or "").replace("\n", " "),
                "followers_count": u.get("followers_count", 0),
                "tweets_count": u.get("tweets_count", 0),
                "verified": u.get("verified", False),
                "location": u.get("location", ""),
            })


export_users_to_csv(get_list_members("1234567890"), "members.csv")

/list-members and /list-followers return profiles in users; /list-tweets returns tweet objects in tweets, with the author under user. Optional profile fields can be empty. When exporting tweets, flatten nested values explicitly, for example {"username": tweet["user"]["username"]}; a CSV writer does not resolve a dotted field name such as user.username.

X List API guide: strategy, cost math, use cases
Real-Time Monitoring: polling patterns for /list-tweets
Target Audience Discovery: using lists for audience research
Marketing Campaign Verification: membership checks
Optimizing API Usage: request batching and rate-limit handling

Getting started

Core Mechanics

Solution Guides

Support & Resources

Lists

Get List Members

Get List Followers

Get List Tweets

Communities

Get Community Members

Get Community Tweets

Search Community Tweets

Exporting to CSV

​Lists

​Get List Members

​Get List Followers

​Get List Tweets

​Communities

​Get Community Members

​Get Community Tweets

​Search Community Tweets

​Exporting to CSV

​Related

Lists

Get List Members

Get List Followers

Get List Tweets

Communities

Get Community Members

Get Community Tweets

Search Community Tweets

Exporting to CSV

Related