更新日志新功能

现已支持 Google AI Overview

Google AI Overviews
关于无线耳机的 Google AI Overview 及其 JSON 结果

发送搜索词，即可获得 Google AI Overview 及其引用页面，以及同一页面上的自然搜索结果、相关问题和相关搜索。

获得的结果

  • aioverview.text 和 aioverview.sources：AI Overview 正文及其引用的页面。
  • organicResults：同一页面上的常规搜索结果，包含排名、标题、链接和摘要。
  • Google 展示时，还会返回 peopleAlsoAsk、relatedSearches、knowledgeGraph 和 ads。

工作原理

每个任务都会从你设定的国家在 Google 上搜索，并读取整个结果页。是否显示 AI Overview 由 Google 针对每次搜索决定，每个完成的结果都会记录 AI Overview 是否出现：出现时内容在 aioverview 中，只有常规结果的页面则为 null。

这条记录直接就是指标。在一组关键词中，出现 AI Overview 的搜索词比例就是 AI Overview 覆盖率，而 AI Overview 的内容则显示 Google 优先展示的品牌和页面。

应用场景

  • 按市场衡量目标关键词中触发 AI Overview 的比例。
  • 查看你的页面是被 AI Overview 引用，还是出现在下方的自然结果中。
  • 从相关问题和相关搜索中挖掘新的跟踪问题。

发送请求

在 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 wireless earbuds for commuting",
      "country": "US"
    }
  }'

请求字段

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

响应

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

JSON
{
  "success": true,
  "task": {
    "id": "310ab45d-209e-4a15-8379-9379ab041d48",
    "taskType": "GOOGLE",
    "status": "COMPLETED",
    "createdAt": "2026-10-02T15:53:21.022Z"
  },
  "credits": { "creditsToCharge": 2, "creditsCharged": 2 },
  "response": {
    "aioverview": {
      "text": "The Anker Soundcore Space A40 is the best wireless earbud for commuting due to its strong adaptive noise cancellation, long battery life, and compact value.",
      "sources": [
        {
          "position": 1,
          "url": "https://www.soundcore.com/products/space-a40-a3936011",
          "label": "Anker Soundcore Space A40"
        },
        {
          "position": 2,
          "url": "https://www.techtimes.com/articles/313618/20260101/best-wireless-bluetooth-earbuds-under-100-are-they-really-worth-price.htm",
          "label": "Tech Times"
        }
      ],
      "shoppingCards": [
        {
          "position": 1,
          "title": "Anker Soundcore Space A40",
          "price": { "raw": "$54.99", "value": 54.99, "currency": "$" },
          "store": "soundcore US",
          "rating": 4.4,
          "reviews": "1.2K"
        }
      ]
    },
    "organicResults": [
      {
        "position": 1,
        "title": "Highest Rated Wireless Earbuds",
        "link": "https://www.amazon.com/Highest-Rated-Wireless-Earbuds/s?k=Highest+Rated+Wireless+Earbuds",
        "snippet": "Soundcore by Anker P20i True Wireless Earbuds, 10mm Drivers with Big Bass, Bluetooth 5.3, 30H Long Playtime, Water-Resistant, 2 Mics for AI Clear Calls, ..."
      }
    ],
    "peopleAlsoAsk": [
      { "question": "What are the best wireless earbuds for office work?" }
    ],
    "relatedSearches": [
      { "query": "Best wireless earbuds for commuting reddit" },
      { "query": "Best wireless earbuds for commuting iphone" }
    ]
  }
}
task.statusstring
依次为 QUEUED、PROCESSING，最终为附带回答的 COMPLETED 或附带 error 的 FAILED。
credits.creditsChargedinteger
已完成任务扣除的积分。失败的任务为 0。
response.aioverviewobject
AI 概览的 text、sources，以及按需返回的 markdown。Google 只显示搜索结果的查询记为 null。
response.aioverview.shoppingCardsarray
概览中展示的商品卡片：标题、价格、商店、评分、评论数和商品链接。
response.organicResultsarray
页面上的搜索结果：position、title、link、snippet 和 page。
response.peopleAlsoAskarray
Google 在页面上列出的相关问题。
response.relatedSearchesarray
页面底部的相关搜索。

获取结果

请求会立即返回 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 个积分。

更多更新

接收最新消息

通过邮件接收产品更新。

RSS 订阅