x/
community-members

The X Community Members API exports the members of a public X community from its link, with each member's bio, location, website, verified flag and follower counts, up to 2,000 per community.

X Community Members API

Community link input
One profile per member
Up to 2,000 members per community
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

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

ParametersRequiredDescription
urlsRequiredPublic X community links in the form https://x.com/i/communities/<numeric_id>, one per line.
results_limitOptionalMembers 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.

  1. POST {"urls": ["https://x.com/i/communities/1493446837214187523"], "results_limit": 100} to /v1/x/community-members.
  2. Poll GET /v1/tasks/{task_id} until status is succeeded.
  3. 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.

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.

Explore other platforms

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

X Community Members API — FAQ

X Community Members API is a programmatic interface for exporting the members of public X communities from their /i/communities/ links. It returns one profile per member with username, bio, location, website, verification status and follower, following and post counts.

Yes. The community link is the only input, so you can export the members of a public community you have never joined, and no X login is involved.

Search a keyword with X Communities Search. Each result includes the community url, which you can pass to this endpoint unchanged.

Up to 2,000. results_limit takes multiples of 20 from 20 to 2,000, defaults to 100 and counts separately for every community link in the request.

No. published_at is the date the member's X account was created. The community join date is not part of the result.

If none of the communities in a request can be found, the task fails and the credits are refunded in full. If only some are missing, the members of the others are still returned.