推文与互动
/v1/tweet/info 返回单条推文的全部指标、媒体与作者对象。如果你手上有多个推文 ID，改用 /v1/tweets/batch —— 单次请求最多 100 个 ID。生产实测：取 30 条推文，批量接口 0.77 秒，逐条循环 9 秒；配额消耗是 1 次而不是 30 次。
看对话用 /v1/tweet/replies（回复树）和 /v1/tweet/thread（按顺序重建推文串）。/v1/tweet/quotes 能找出谁引用了某条推文、说了什么 —— 当「引用风暴」比回复更重要时特别有用。
复合接口在内部并发多次抓取、只回一个对象：/v1/user/whois 做账号尽调、/v1/tweet/engagement 出互动汇总、/v1/batch/user_info 单次取最多 100 个资料。它们的意义是替你省往返次数，定价也低于拆开单独调用。
注意：X 已封锁点赞者数据，所以没有「点赞者」接口；/v1/tweet/retweeters（转推者）可用，返回完整资料。
本页 9 个接口
GET/v1/tweet/info
推文详情
含全部互动数和作者的单推详情。
参数
idstring必填推文 id
响应
200 OKhttps://socialapi.tech/v1/tweet/info
{ "status": "success", "data": {
"id": "2078...", "text": "...", "like_count": 109,
"retweet_count": 17, "view_count": 45152,
"author": { ... } } }GET/v1/tweet/replies
回复列表
某推文的回复。
参数
idstring必填推文 id
limitint可选默认 20
响应
200 OKhttps://socialapi.tech/v1/tweet/replies
{ "status": "success", "data": [ ...replies ] }GET/v1/tweet/thread
完整线程
按时间正序的完整线程。
参数
idstring必填推文 id
limitint可选默认 50
响应
200 OKhttps://socialapi.tech/v1/tweet/thread
{ "status": "success", "data": [ ...thread tweets ] }GET/v1/tweet/retweeters
转发者
转发了该推文的用户(分页)。
参数
idstring必填推文 id
cursorstring可选游标
limitint可选默认 100
响应
200 OKhttps://socialapi.tech/v1/tweet/retweeters
{ "status": "success", "data": [ ...users ], "meta": { "next_cursor": "..." } }GET/v1/user/whois
Whois 尽调
一次调用：资料 + 账号透明度(所在地/来源App/改名次数) + 最近推文。并发。
参数
usernamestring必填X 用户名
tweet_limitint可选默认 10
响应
200 OKhttps://socialapi.tech/v1/user/whois
{ "status": "success", "data": {
"profile": { ... },
"about": {
"account_based_in": "United States",
"connected_via": "United States App Store",
"username_changes": 0, ...
},
"recent_tweets": [ ... ] } }GET/v1/tweet/engagement
互动全景
一次调用：转发者 + 回复。并发聚合。
参数
idstring必填推文 id
limitint可选默认 20
响应
200 OKhttps://socialapi.tech/v1/tweet/engagement
{ "status": "success", "data": {
"retweeters": [ ... ],
"replies": [ ... ] } }GET/v1/batch/user_info
批量资料
一次并发调用最多 100 个资料。
参数
usernamesstring必填逗号分隔, ≤100
响应
200 OKhttps://socialapi.tech/v1/batch/user_info
{ "status": "success", "data": [ ...profiles ],
"meta": { "count": 3 } }GET/v1/tweets/batch
批量取推文
单次请求最多 100 条 —— 比逐条查询每条快约 70 倍。
参数
idsstring必填逗号分隔的推文 id，最多 100
响应
200 OKhttps://socialapi.tech/v1/tweets/batch
{ "status": "success", "data": [ /* tweets */ ],
"meta": { "count": 100, "requested": 100, "missing": 0 } }GET/v1/tweet/quotes
引用推文
谁引用了这条推文、说了什么。X 的索引偏向近期内容。
参数
idstring必填推文 id
limitint可选默认 20
响应
200 OKhttps://socialapi.tech/v1/tweet/quotes
{ "status": "success", "data": [ /* quote tweets */ ],
"meta": { "count": 20 } }