X Community Members
X Community Members are the accounts that have chosen to join a topic-based community, and each one carries a public profile with a bio, location, website, verification status, account creation date and follower, following and post counts. Because joining is a deliberate act around a single subject, these profiles describe a self-selected audience that can be sized up, segmented by reach or place, and set against the membership of a neighbouring community.
X Community Members API Features
- Member lists from community linksPaste one or more https://x.com/i/communities/<id> links into the X Community Members API and every member of each community comes back as its own profile row.
- Who each member isRows carry the username, display name, bio in text, avatar, cover image, website and stated location, so a member can be recognised and described from the export alone.
- Reach of every memberIn X Community Members API rows, metrics holds followers_count, following_count and posts_count, which separates the large voices in a community from its quiet majority.
- Verification and account ageis_verified, is_private and published_at, the date the member's X account was created, show at a glance how established each person in the list is.
X Community Members API Parameters
| Parameters | Required | Description |
|---|---|---|
urls | Required | Public X community links in the form https://x.com/i/communities/<numeric_id>, one per line. |
results_limit | Optional | Members to return for each community, a multiple of 20 from 20 to 2,000. Defaults to 100. |
How to Use the X Community Members API
Send community links to the X Community Members API and page through the member profiles.
- POST {"urls": ["https://x.com/i/communities/1493446837214187523"], "results_limit": 100} to /v1/x/community-members.
- Poll GET /v1/tasks/{task_id} until status is succeeded.
- Read member profiles from results.items and send results.next_cursor back while has_more is true.
curl -X POST "https://api.socq.ai/v1/x/community-members" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://x.com/i/communities/1493446837214187523"],"results_limit":100}'
# results_limit is applied to each community in urls, so two links can return up to 200 members here.X Community Members API Use Cases
- Profiling a community's audience: Group members by location.name, scan bios in text for job titles and interests, and chart followers_count to describe who actually joined a community.
- Shortlisting members for partnerships: Sort members by metrics.followers_count, keep the verified ones and use website and bio to pick the creators worth contacting inside a niche.
- Measuring overlap between two communities: Export the members of two related communities with the X Community Members API and match them on id to count the people who belong to both.
- Screening a community for fresh accounts: Combine a recent published_at with low posts_count and followers_count to see what share of a community's members are newly created or barely active accounts.
X Community Members API Pro Tips
- Send one community per X Community Members API task when you plan to compare memberships; member rows carry the profile only, so the task input is what ties each row to its community.
- Read members_count from X Community or X Communities Search first and set results_limit to the next multiple of 20 above it to request the whole list in one task.
- Normalise location.name before grouping by country: it holds the free-text place a member typed, such as "Sydney", and the city and country fields are often empty.
Related APIs
Beyond the X Community 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 Community API — Read community links for descriptions, membership counts, rules and joining policies.
- 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 Community Moderators API — Get the admins and moderators who run a community, as full profiles.
- Twitter Tweet Scraper API
- Twitter User Tweets Scraper API
- Twitter Search API
- X Post Quotes API
- X Post Replies API
- X Post Retweeters API
- X Trends API
- Twitter Mentions API
- Twitter User Search API
- X Community Posts API
- X Thread Context API
- X Verified Followers API
- X List Tweets API
- Twitter List Members API
- Twitter List Followers 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