Communities & Lists
X Communities are topic-scoped spaces with their own posting streams, and they're where a lot of niche discussion has moved. /v1/community/info returns the name, description, member count and join policy. /v1/community/tweets reads the posting stream.
One thing worth knowing about the community stream: the ranking parameter does not sort a single result set — it selects between three largely non-overlapping ones. In testing, Recency and Likes shared zero posts. Use Recency when freshness matters (median post age around 6 hours) and Likes when you want high-engagement content (median age around 8 days).
/v1/community/members paginates with a cursor and returned zero duplicates across 39 consecutive pages in testing. /v1/community/moderators returns the moderator list in a single call — it's typically a handful of accounts.
X Lists work similarly: /v1/list/timeline pulls posts from every account on a list, which is a convenient way to follow a curated set without subscribing to each account. /v1/list/members and /v1/list/subscribers cover the two sides of list membership.
List Timeline
Mixed timeline of a List's members.
{ "status": "success", "data": [ ...tweets ] }List Members
Members of a List (paginated).
{ "status": "success", "data": [ ...users ] }List Subscribers
Subscribers of a List (paginated).
{ "status": "success", "data": [ ...users ] }Community Info
Name, description, member count, join policy and rules.
{ "status": "success", "data": {
"name": "Startup Community", "member_count": 191429,
"join_policy": "Open" } }Community Tweets
Posts inside an X Community. `ranking` picks between three largely different result sets.
{ "status": "success", "data": [ /* tweets */ ],
"meta": { "count": 20, "ranking": "Recency" } }Community Members
Member list with cursor pagination — measured zero duplicates across 39 pages.
{ "status": "success", "data": [ /* users */ ],
"meta": { "count": 100, "next_cursor": "..." } }Community Moderators
Moderator list — typically single digits, returned in one call.
{ "status": "success", "data": [ /* users */ ],
"meta": { "count": 10 } }