# 从第一条请求，到读懂统一响应

用无需密钥的演示请求，完成接口选择、参数填写、JSON 阅读与分页，理解DataNavoAPI统一 API 的返回结构。

页面：https://datanavoapi.com/guides/first-api-call/

先把一条数据流走通：选择能力、给出输入、收到结果，再决定怎样接进自己的应用。这个过程使用固定的虚构样本，无需供应商 Key。

输入：一个关键词，以及能访问 DataNavoAPI 的浏览器或终端。

输出：一份能读懂、能复制、能继续翻页的结构化响应。

可用范围：全文使用 demo。请求返回固定样本，不消耗供应商额度。

## 选择与你的任务匹配的能力

需要发现内容，先选搜索接口；已经有一条内容的编号，选详情或评论接口。这里以 YouTube 视频搜索为例，关键词填 coffee brewing，排序选择 relevance。

打开下方演示入口后，页面会预选能力；点击“运行”才会发起请求。更换关键词能练习参数流程，但演示内容始终是固定的虚构样本，不代表该词的真实搜索结果。

## 在浏览器或终端发起请求

在浏览器中可以使用调试台。在终端中运行下方命令，即可查看同一份演示响应。

```
curl --get 'https://datanavoapi.com/v1/youtube/videos/search' \
  -H 'X-Guanliu-Mode: demo' \
  --data-urlencode 'query=coffee brewing' \
  --data-urlencode 'sort=relevance'
```

## 先读状态，再读数据

HTTP 成功不等于你已经拿到真实数据。先确认 code 为 ok，再检查 meta.mode。demo 表示虚构样本，live 才表示请求走了真实供应商。

搜索返回 data.items 数组；详情或账号查询返回 data.item 对象。计数缺失时可能是 null，不能自行当作 0。需要排查时保存 request_id，查看 warnings 中的提示。

- code：请求的业务结果。
- data：供你的应用处理的内容。
- page：是否还有下一页，以及下一页游标。
- meta：模式、能力、来源与本次请求信息。

## 翻页与导出

当 page.has_more 为 true 且 next_cursor 有值时，调试台可点击“下一页”。自己写代码时，将完整 next_cursor 作为 cursor 参数，保持关键词与排序不变。不要拆解、修改或跨接口复用游标。

点击“复制响应”，可将 JSON 粘贴到转换工具生成 CSV。先保留原始 JSON，再按自己的用途整理表格；CSV 不保留原始 JSON 的全部类型信息。

[打开 JSON 转 CSV 工具](https://datanavoapi.com/tools/json-to-csv/)

## 相关能力

- [搜索 YouTube 视频](https://datanavoapi.com/apis/youtube/videos/search/)

## 机器接入与数据说明

演示固定返回虚构样本，请检查 meta.mode，不得作为实时市场事实。MCP 默认 demo，可显式配置客户 Key 使用 simulated；SDK 固定模拟模式。模拟调用只消耗 TEST_CREDIT，真实供应商和支付保持关闭。

[能力合同](https://datanavoapi.com/catalog.json)

[OpenAPI](https://datanavoapi.com/openapi.json)

[Agent 指引](https://datanavoapi.com/agents.md)
