AI 搜索数据 API 快速开始

1. 准备 API 密钥

创建免费账户并在控制台生成密钥，将其保存到 QUERYING_API_KEY 环境变量。

2. 提交问题

向 Gemini 提交问题，并在下一步使用受理响应中的 task.id。国家代码不会翻译问题。

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "taskType": "GEMINI",
  "payload": {
    "prompt": "通勤无线耳机推荐",
    "country": "CN"
  }
}'

3. 获取完成结果

QUEUED 或 RUNNING 时隔一段时间重试，COMPLETED 后读取 response。FAILED 必须作为错误处理。

curl https://api.querying.ai/v1/async/task/TASK_ID \
  -H "Authorization: Bearer $QUERYING_API_KEY"

4. 使用 Webhook 自动接收

在提交 JSON 中加入 webhook.url，实现签名校验，并用 task.id 去重。

{
  "taskType": "GEMINI",
  "payload": {
    "prompt": "通勤无线耳机推荐",
    "country": "CN"
  },
  "webhook": {
    "url": "https://your-server.example.com/querying-webhook"
  }
}

5. 添加引擎和定期测量

先确认每个引擎的 taskType、输入字段和响应结构，再扩展集成。

相关功能