社区与列表
X 社区是按主题划分的空间，有各自独立的发帖流 —— 很多垂直领域的讨论已经迁到了那里。/v1/community/info 返回名称、简介、成员数与加入策略；/v1/community/tweets 读取发帖流。
关于社区推文流有一点值得知道：ranking 参数**不是给同一批结果排序**，而是在三批基本不重叠的结果里选一批。实测 Recency 与 Likes 的结果**零重叠**。要时效性用 Recency（推文中位年龄约 6 小时），要高互动内容用 Likes（中位年龄约 8 天）。
/v1/community/members 支持游标翻页，实测连翻 39 页零重复。/v1/community/moderators 单次调用返回版主列表 —— 通常只有个位数个账号。
X List 的用法类似：/v1/list/timeline 拉取列表内所有账号的推文，是「不用逐个关注就能跟踪一批账号」的便捷方式；/v1/list/members 与 /v1/list/subscribers 覆盖成员关系的两侧。
本页 7 个接口
GET/v1/list/timeline
列表时间线
List 成员的混合时间线。
参数
list_idstring必填列表 id
limitint可选默认 20
响应
200 OKhttps://socialapi.tech/v1/list/timeline
{ "status": "success", "data": [ ...tweets ] }GET/v1/list/members
列表成员
某 List 的成员(分页)。
参数
list_idstring必填列表 id
cursorstring可选游标
limitint可选默认 100
响应
200 OKhttps://socialapi.tech/v1/list/members
{ "status": "success", "data": [ ...users ] }GET/v1/list/subscribers
列表订阅者
某 List 的订阅者(分页)。
参数
list_idstring必填列表 id
cursorstring可选游标
limitint可选默认 100
响应
200 OKhttps://socialapi.tech/v1/list/subscribers
{ "status": "success", "data": [ ...users ] }GET/v1/community/info
社区详情
名称、简介、成员数、加入策略与规则。
参数
community_idstring必填社区 id
响应
200 OKhttps://socialapi.tech/v1/community/info
{ "status": "success", "data": {
"name": "Startup Community", "member_count": 191429,
"join_policy": "Open" } }GET/v1/community/tweets
社区推文
X 社区内的推文。`ranking` 三个取值对应三批基本不重叠的结果。
参数
community_idstring必填社区 id
limitint可选默认 20
rankingstring可选Recency | Relevance | Likes
cursorstring可选分页游标
响应
200 OKhttps://socialapi.tech/v1/community/tweets
{ "status": "success", "data": [ /* tweets */ ],
"meta": { "count": 20, "ranking": "Recency" } }GET/v1/community/members
社区成员
成员列表，支持游标翻页 —— 实测连翻 39 页零重复。
参数
community_idstring必填社区 id
limitint可选默认 100
cursorstring可选分页游标
响应
200 OKhttps://socialapi.tech/v1/community/members
{ "status": "success", "data": [ /* users */ ],
"meta": { "count": 100, "next_cursor": "..." } }GET/v1/community/moderators
社区版主
版主列表 —— 通常个位数，一次全部返回。
参数
community_idstring必填社区 id
响应
200 OKhttps://socialapi.tech/v1/community/moderators
{ "status": "success", "data": [ /* users */ ],
"meta": { "count": 10 } }