快速开始：第一次调用 okdata

1. 拿到 key

key 以 okd_ 开头。自助注册还没开放，发邮件到 hello@okdata.online，我们会发给你。把它放进环境变量，不要写进代码：

export OKDATA_API_KEY="okd_..."

2. 先看再花钱

状态接口免费、不需要 key，可以看到当前哪些接口可用：

curl https://api.okdata.online/v1/catalog/status

3. 调用一次

按关键词搜小红书笔记。路径就是把接口 id 的点换成斜杠：

curl -G "https://api.okdata.online/v1/xiaohongshu/notes/search" \
  -H "Authorization: Bearer $OKDATA_API_KEY" \
  --data-urlencode 'query=防晒霜 推荐'

这是一次调用，费用 $0.02，返回一页约 20 篇笔记。

4. 看懂返回

{
  "code": "ok",
  "data": { "items": [ { "id": "6731f0a2000000001b02c3d4", "type": "image", "title": "...", "metrics": { "likes": 48200, "views": null } } ] },
  "page": { "next_cursor": "eyJvIjoyMH0", "has_more": true },
  "meta": {
    "billing": { "amount": "0.018", "currency": "USD", "balance_after": "9.982" },
    "unavailable": { "metrics.views": "platform" }
  }
}

• data.items 是笔记列表。所有平台都返回同样的 Post 结构。
• meta.billing.amount 是这次调用花的钱，单位美元。
• meta.unavailable 列出为 null 的字段和原因。小红书不展示浏览量，所以 metrics.views 为 null，原因是 platform。

5. 翻到下一页

把 page.next_cursor 作为 cursor 传回去。每一页都是一次单独计费的调用；够用了就停，或者等 page.has_more 变成 false。

curl -G "https://api.okdata.online/v1/xiaohongshu/notes/search" \
  -H "Authorization: Bearer $OKDATA_API_KEY" \
  --data-urlencode 'query=防晒霜 推荐' \
  --data-urlencode 'cursor=eyJvIjoyMH0'

6. 调用失败时

错误统一返回 code、message、charged 和 retry。失败的调用不扣费。超时会返回 charged: null，用同一个 Idempotency-Key 重发，绝不会重复扣费。全部错误码见错误码页。

接下来

• 用 MCP 把同样的数据交给 AI 智能体。
• 浏览全部 35 个接口和价格。
• 了解请求、翻页、view 和 fields。