Felo X 用户帖子
供应商：Felo · 使用平台余额
按需要的数据选择接口。五个接口均使用 POST，结果直接位于 JSON 根层级，没有统一的 data 外层。
示例使用总览中配置的 FELO_API_KEY。调用使用平台余额，不使用 Felo Pro 积分。响应示例仅展示结构，实际内容和可选字段会变化。
3. 查询用户帖子
POST /api/v1/data/x/user/tweets
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
username | string | 至少提供一个用户标识 | 用户名，最长 100 字符 |
x_user_id | string | 至少提供一个用户标识 | 用户 ID，最长 100 字符；同时提供时优先使用 ID |
limit | integer | 否 | 1–1,000；当前实现至少按 20 条处理，默认 20 |
cursor | string | 否 | 分页游标，最长 4,000 字符 |
include_replies | boolean | 否 | 是否附带嵌套回复；默认 false |
curl -sS --request POST "https://openapi.felo.ai/api/v1/data/x/user/tweets" \
-H "Authorization: Bearer $FELO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username":"OpenAI","limit":20,"include_replies":false}'返回 tweets、total、has_next 和 next_cursor。把 limit 设为小于 20 的值，不代表一定减少返回数量或费用。包含回复可能增加返回数据量及计费条数。
数量与嵌套回复边界
limit 是本次请求希望收集的主帖数量，不是保证返回的数量。当前实现按至少 20 条处理：目标为 20 条时读取一页；目标大于 20 条时自动向上游翻页，最多读取 50 页。每轮取页前会检查累计时间，超过 60 秒便停止继续取页；该检查不是整个 HTTP 请求必须在 60 秒内结束的承诺。
达到目标、上游没有下一页、返回空页、游标缺失或达到上述限制时，都会停止收集。因此成功响应也可能少于 limit。需要继续时，按响应的 has_next 和 next_cursor 分页。
include_replies=true 时，每个返回主帖额外收集最多 5 页、最多 100 条嵌套回复，遇到无下一页、空页或无法继续的游标会提前结束。limit 不包含这些嵌套回复，主帖的 total 也不包含它们；回复仍可能增加计费条数。
嵌套 replies 不是完整回复存档，也不提供这一轮附加收集的独立翻页游标。需要单独分页读取回复时，请调用“查询帖子回复”，使用该接口返回的游标；不要将主帖的 next_cursor 用于回复。
分页与费用控制
total 表示本次响应中对应数组的条数；帖子查询的 total 只统计主帖，回复查询则逐组统计。它不是全站匹配总数、帖子完整回复总数或最终计费条数。
- 首次请求不传
cursor。 - 读取
has_next和next_cursor；查询回复时，读取每个results项中的这两个字段。 - 有下一页且游标非空时，保持查询条件不变，原样传回游标。批量回复需要逐个帖子继续分页。
- 没有下一页、游标重复，或达到应用自己的页数和费用上限时停止。
分页状态反映上游最后一次返回的状态；达到数量上限后返回的集合可能经过截取。即使 has_next=false，也不能据此承诺已取得 X 上的全部历史或全部回复。应用应展示实际返回条数，避免把有限结果标记为“全部数据”。
每次成功翻页都可能产生费用。五个接口按返回结果条数计费，不是固定的每次请求价格。嵌套回复等记录可能影响计费条数，不要只用最外层数组长度估算费用。请结合当前价格表和控制台用量查看。完整对象字段见 OpenAPI 定义。