Felo API PlatformFelo API Platform

Felo X 帖子回复

供应商:Felo · 使用平台余额

按需要的数据选择接口。五个接口均使用 POST,结果直接位于 JSON 根层级,没有统一的 data 外层。

示例使用总览中配置的 FELO_API_KEY。调用使用平台余额,不使用 Felo Pro 积分。响应示例仅展示结构,实际内容和可选字段会变化。

5. 查询帖子回复

POST /api/v1/data/x/tweet/replies

字段类型必填说明
tweet_idsstring 或 string[]是单个帖子 ID,或最多 20 个 ID 的数组
cursorstring否最长 4,000 字符;分页时只提交一个帖子 ID
since_timeinteger否起始时间,Unix 秒数
until_timeinteger否截止时间,Unix 秒数

把占位符替换为真实帖子 ID:

curl -sS --request POST "https://openapi.felo.ai/api/v1/data/x/tweet/replies" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tweet_ids":["POST_ID"]}'

与帖子搜索不同,回复按原帖子分组放在 results 中,每组有自己的分页状态:

{"results":[{"tweet_id":"POST_ID","replies":[],"total":0,"has_next":false,"next_cursor":null}]}

单次回复数量边界

每次请求对每个 tweet_id 读取一页上游回复,最多保留 100 条,不会自动翻完该帖子的所有回复。批量传入最多 20 个 ID 时,100 条的上限分别作用于每个 results 项,实际返回可以少于上限。

每组的 total 是该组本次返回的回复条数,不是该帖子的全部回复数。需要后续页时,取这一组的 next_cursor,下一次只提交对应的一个 tweet_id;接口没有用于提高单次上限的 limit 参数。

分页与费用控制

total 表示本次响应中对应数组的条数;帖子查询的 total 只统计主帖,回复查询则逐组统计。它不是全站匹配总数、帖子完整回复总数或最终计费条数。

  1. 首次请求不传 cursor。
  2. 读取 has_next 和 next_cursor;查询回复时,读取每个 results 项中的这两个字段。
  3. 有下一页且游标非空时,保持查询条件不变,原样传回游标。批量回复需要逐个帖子继续分页。
  4. 没有下一页、游标重复,或达到应用自己的页数和费用上限时停止。

分页状态反映上游最后一次返回的状态;达到数量上限后返回的集合可能经过截取。即使 has_next=false,也不能据此承诺已取得 X 上的全部历史或全部回复。应用应展示实际返回条数,避免把有限结果标记为“全部数据”。

每次成功翻页都可能产生费用。五个接口按返回结果条数计费,不是固定的每次请求价格。嵌套回复等记录可能影响计费条数,不要只用最外层数组长度估算费用。请结合当前价格表和控制台用量查看。完整对象字段见 OpenAPI 定义。

需要帮助?