选择与你的任务匹配的能力
需要发现内容,先选搜索接口;已经有一条内容的编号,选详情或评论接口。这里以 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 的全部类型信息。