更新日志改进

以 Markdown 格式获取 Google AI Overview

Google AI Overviews
以 Markdown 获取的 Google AI Overview，以及同一内容按标题和表格渲染后的效果

通过 aioverview.markdown 读取 AI Overview，完整保留 Google 排布的标题、列表和表格。

更新内容

  • aioverview.markdown：以 Markdown 返回 AI Overview，标题、列表、表格和粗体都保留在原处。
  • aioverview.text 保持原样，文字内容相同，读取纯文本的代码照常运行。
  • Google AI Mode 的回答在每个结果中以 markdown 提供同样格式的 Markdown。

工作原理

Google 用标题、编号步骤、项目列表和对比表格来组织 AI Overview。aioverview.text 保存文字，aioverview.markdown 还保留整个结构，你可以按搜索用户看到的样子展示它，也可以在代码中读取它的结构。引用页面仍在 aioverview.sources 中。

用 include.aioverview.markdown: true 开启。其他引擎通用的 include.markdown: true 也能开启。

应用场景

  • 在你自己的仪表盘和报告中按原始格式展示 AI Overview。
  • 查看 Google 在 AI Overview 的步骤、表格和对比中列出了哪些品牌。
  • 按章节拆分 AI Overview，看 Google 先讲哪些主题。

发送请求

在 Authorization 请求头中带上 API 密钥发送请求。

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskType": "GOOGLE",
    "payload": {
      "query": "best robot vacuum for pet hair",
      "country": "US",
      "include": { "markdown": true }
    }
  }'

请求字段

taskTypestring必填
要运行的引擎，例如 CHATGPT 或 GOOGLE。
payload.querystring必填
按用户在搜索框中输入的方式写的搜索词。
payload.countrystring
提问所在市场的两位国家代码，例如 US、KR、JP。默认 US。
payload.include.markdownboolean
设为 true 会附带 aioverview.markdown：按 Google 页面的版式保留标题、列表和表格的概览。
webhook.urlstring
你服务器上的 HTTPS 地址。任务完成后立即把结果推送到这里。

响应

完成的任务如下所示，已截取部分内容。

JSON
{
  "success": true,
  "task": {
    "id": "8dcde5b1-2f53-40b3-b048-05075b03c4a9",
    "taskType": "GOOGLE",
    "status": "COMPLETED",
    "createdAt": "2026-10-02T17:16:57.237Z"
  },
  "credits": { "creditsToCharge": 2, "creditsCharged": 2 },
  "response": {
    "aioverview": {
      "text": "The Roborock Saros Z70 and the MOVA V50 are top choices for pet hair, combining powerful suction with specialized anti-tangle brush rollers.",
      "markdown": "The Roborock Saros Z70 and the MOVA V50 are top choices for pet hair, combining powerful suction with specialized anti-tangle brush rollers.\n\n### Top Robot Vacuums for Pet Hair\n\n**Roborock Saros Z70**\n\nNamed a top overall pick by experts for its strong hard-floor pickup, smart obstacle recognition, and self-emptying dock. It costs around $1,000.\n\n**MOVA V50**\n\nPraised as a top performer in dog hair tests and obstacle avoidance. It features a dual brush roller and app controls for auto-emptying frequency, usually priced under $700.\n\n…",
      "sources": [
        {
          "position": 2,
          "url": "https://www.rtings.com/robot-vacuum/reviews/best/pet-hair",
          "label": "RTINGS.com"
        },
        {
          "position": 3,
          "url": "https://www.forbes.com/sites/forbes-personal-shopper/article/best-robot-vacuum-for-pet-hair/",
          "label": "Forbes Vetted"
        }
      ]
    }
  }
}
task.statusstring
依次为 QUEUED、PROCESSING，最终为附带回答的 COMPLETED 或附带 error 的 FAILED。
credits.creditsChargedinteger
已完成任务扣除的积分。失败的任务为 0。
response.aioverviewobject
AI 概览的 text、sources，以及按需返回的 markdown。Google 只显示搜索结果的查询记为 null。
response.aioverview.markdownstring
按 Google 页面结构转换的概览 Markdown：### 小标题、列表、表格和粗体。

获取结果

请求会立即返回 status 为 QUEUED 的任务。用 GET /v1/async/task/{id} 轮询，直到 status 变为 COMPLETED 或 FAILED；或者加上 webhook.url，在服务器上接收同样的 task、credits 和 response。任务结束后，结果保留 24 小时供查询。

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

价格

价格保持每个完成的任务 2 个积分，已包含 Markdown。

更多更新

接收最新消息

通过邮件接收产品更新。

RSS 订阅