帖子回复 API
用帖子 ID 或帖子链接拉取回复,用游标翻页;每条返回回复 ID、正文、作者、点赞数和发布时间。
拉取一条 X 帖子下的回复。tweet_id 或帖子链接二选一,用 cursor 翻页。每条含回复 ID、正文、作者、点赞、发布时间和再回复数。
这是这一条帖子的直接回复,不是全站搜索。
请求地址 POST https://www.xmedi.cn/api/v1/twitter/posts/comments。调用成功才扣费,参数错误、平台侧失败或超时不扣费。
成功响应的 meta 含数据血缘,说明见 鉴权与计费。
适用场景
- 舆情:看原帖下面的反对和补充。
- 客服:找出需要官方再回复的留言。
- 入库:用 comment_id 去重。
请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
cursor |
string | 否 | 翻页游标,取上一页 next_cursor;首页留空。 |
tweet_id |
string | 否 | 帖子 ID。与 url 二选一。 |
url |
string | 否 | 帖子链接。 |
返回 data 字段
| 字段 | 类型 | 说明 |
|---|---|---|
has_more | boolean | 是否还有下一页。 |
items | array<object> | 回复列表。每条含 comment_id、content、author、like、publish_time、reply_num。 |
next_cursor | string | |
page | number | |
page_size | number | |
total | number |
调用示例
curl -X POST https://www.xmedi.cn/api/v1/twitter/posts/comments \
-H "X-XMEDI-Key: xm_live_xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"tweet_id":"2121280846183137564"}'
返回示例
以下为 data 的字段结构示意,实际取值以调用结果为准。
{
"has_more": false,
"items": [
{
"author": {
"id": "1000000000000000002",
"name": "示例用户",
"username": "example2"
},
"comment_id": "1800000000000000002",
"content": "示例回复内容",
"like": 0,
"publish_time": "2026-01-01T01:00:00Z",
"reply_num": 0
}
],
"next_cursor": "",
"page": 1,
"page_size": 20,
"total": 1
}
注意事项
- 原帖自己的正文在帖子详情,不在本列表里。
- 没有回复时看是否成功返回空列表。
常见错误码
| code | error_code | 含义与处理 |
|---|---|---|
| 40001 | VALIDATION_ERROR | 参数校验失败,按返回提示修改请求,不扣费 |
| 40100 | UNAUTHORIZED | API Key 缺失、错误或已吊销,到控制台检查 Key |
| 40200 | INSUFFICIENT_BALANCE | 余额不足,充值后重试 |
| 42900 | RATE_LIMITED | 超过每分钟 60 次上限,稍后重试 |
| 50000 | INTERNAL_ERROR | 服务异常,可稍后重试,不扣费 |
| 50300 | NOT_AVAILABLE | 接口暂不可用,不扣费 |
常见问题
- 和帖子搜索有什么区别?
- 搜索按关键词找帖子。本接口只取某一条帖子下面的回复。
- reply_num 是什么?
- 这条回复下面还有多少条再回复,不是回复正文。
- 调用失败会扣费吗?
- 帖子不存在不扣费。成功但没有回复会计费。
相关接口
需要接入这个接口?
免费注册
注册后创建 API Key,或留下联系方式获取方案