apiCode 为 geo.questions_corr_recommend。
1. 准备请求
所有开放 API 共用以下地址:apiCode 和 data。当前接口只需要一个关键词。
2. 发送请求
先把 API Key 写入当前终端会话的环境变量,避免把真实密钥保存到脚本中。- PowerShell
- macOS / Linux
上述 cURL 命令适用于 macOS、Linux、Git Bash 和 WSL。Windows PowerShell 的完整命令见 cURL 调用。
3. 判断结果
请求成功后,平台返回统一外层结构,具体问题列表位于data.result。
首次调用完成后,请确认 HTTP 状态正常、业务
code = 200,并保存 data.requestId。本教程以 SYNC 同步模式 的接口为例。若您调用的接口为 ASYNC 异步模式(如 GEO 排名、品牌得分等),提交接口将返回
taskId,需要通过轮询查询结果。详细逻辑请参考 同步与异步任务模式。4. 首次调用验收
- 返回体可以解析为 JSON。
- HTTP 状态符合预期,并且业务
code为200。 data.result.aiQuestions和data.result.baiduQuestions按数组读取。- 日志中保存了
data.requestId,且没有记录完整 API Key。
同步与异步模式
了解 SYNC/ASYNC 执行区别与轮询规范。
查看完整接口定义
查看全部业务接口参数与返回结构。
处理错误响应
区分参数、认证、权限、限流和平台错误。