<p class="crumbs"><a href="/zh/docs/">文档</a></p>

# 请求和返回

## 请求

接口 ID 把点换成斜杠就是路径：`douyin.videos.comments.list` 是 `GET /v1/douyin/videos/comments/list`。参数放在查询字符串里；也可以用 POST 发 JSON。

## 返回

所有接口都返回同一种格式：

```json
{
  "code": "ok",
  "request_id": "req_…",
  "data": {
    "items": [
      "…"
    ]
  },
  "page": {
    "next_cursor": "…",
    "has_more": true
  },
  "warnings": [],
  "meta": {
    "endpoint": "douyin.videos.comments.list",
    "platform": "douyin",
    "fetched_at": "2026-11-19T08:00:00.000Z",
    "billing": {
      "charged": true,
      "amount": "0.002",
      "currency": "USD",
      "balance": "9.98"
    }
  }
}
```

| 字段 | 说明 |
| --- | --- |
| `data.item` / `data.items` | 单个对象接口返回 item，列表接口返回 items |
| `page.next_cursor` | 下一页的游标；为 null 表示没有了 |
| `meta.billing` | 这次扣了多少、还剩多少（美元） |
| `meta.fetched_at` | 从平台取数的时间 |
| `warnings` | 提示，例如「No results」 |
| `request_id` | 这次调用的编号，查账和反馈问题时用 |

## 翻页

列表接口有 `page.next_cursor` 时，把它原样作为 `cursor` 参数传回来，其他参数保持不变。每一页单独计费。游标只能用在产生它的接口上。

## view=full

加上 `view=full`，返回里会附上平台的原始数据 `raw`，价格不变。统一字段不够用时可以从这里取。

## 查一次调用

```bash
curl "https://api.feedmcp.com/v1/calls/req_…" -H "Authorization: Bearer $FEEDMCP_API_KEY"
```

---

网页版: https://feedmcp.com/zh/docs/requests/
