# Felo X 用户资料

POST /api/v1/data/x/user/info

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

示例使用[总览](https://openapi.felo.ai/zh-CN/docs/data-api/guides/felo-overview.md)中配置的 `FELO_API_KEY`。调用使用**平台余额**，不使用 Felo Pro 积分。响应示例仅展示结构，实际内容和可选字段会变化。





## 1. 查询用户资料

`POST /api/v1/data/x/user/info`

| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| `usernames` | string[] | 是 | 1–100 个用户名，建议不带 `@` |

```bash
curl -sS --request POST "https://openapi.felo.ai/api/v1/data/x/user/info" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["OpenAI"]}'
```

返回 `users` 和 `total`。每个用户包含 `user_id`、`username`、`display_name`，还可能有简介、粉丝数、认证状态等元数据。批量查询可能只返回部分用户，请按用户名或 ID 匹配，不要按数组下标对应。

```json
{"users":[{"user_id":"example-user-id","username":"example","display_name":"Example"}],"total":1}
```



## 分页与费用控制

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

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

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

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