更新日志新功能

新增搜索结果和 Reddit

Search results
Playground 中并排显示的 Google Search 结果和 Reddit 帖子

通过与 AI 回答相同的 API，以 JSON 获取 Google、Bing、Naver 的搜索结果和 Reddit 讨论。

获得的结果

  • GOOGLE_SERP：包含排名、标题、链接和摘要的自然搜索结果，以及相关问题、相关搜索和广告。把 page 设为 1 到 10 可获取更深的页面。
  • BING_SEARCH：Bing 的搜索结果，以及 Bing 在结果上方生成的 AI 摘要和来源，位于 aioverview。
  • NAVER_SERP：Naver 的网页文档，每页 15 条，page 可设为 1 到 10。
  • REDDIT：帖子搜索、带评论的单个帖子，或某个子版块的最新帖子。

工作原理

AI 引擎从网络中组织回答，因此搜索中排名靠前的页面和人们在 Reddit 上写的帖子，就是 AI 曝光的原材料。这些引擎把这些数据带进你已经在用的流程：同样的请求、同样的 webhook、同样的 JSON 格式。

排名跨页连续计算，因此 Google 第 2 页的第一条结果排名为 11。每个任务读取的都是采集时的实时结果。

应用场景

  • 在同一个搜索词下，比较搜索排名靠前的网站与 AI 回答引用的网站。
  • 追踪在你所在品类中影响口碑的 Reddit 帖子。

发送请求

在 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_SERP",
    "payload": {
      "query": "best project management software for small teams",
      "country": "US"
    }
  }'

BING_SEARCH 和 NAVER_SERP 也以同样方式发送，在 payload 中填入 query。

请求字段

taskTypestring必填
要运行的引擎，例如 CHATGPT 或 GOOGLE。
payload.querystring必填
按用户在搜索框中输入的方式写的搜索词。
payload.countrystring
提问所在市场的两位国家代码，例如 US、KR、JP。默认 US。
payload.pageinteger
要读取的结果页，1 到 10，默认 1。position 跨页连续计数。
webhook.urlstring
你服务器上的 HTTPS 地址。任务完成后立即把结果推送到这里。
idempotencyKeystring
你为请求设定的 ID。每个键在账户内对应一个任务，因此重试发送后仍是同一个任务。

响应

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

JSON
{
  "success": true,
  "task": {
    "id": "323287e6-d4ef-4797-a337-f6c3b574b7ab",
    "taskType": "GOOGLE_SERP",
    "status": "COMPLETED",
    "createdAt": "2026-10-02T15:45:07.237Z"
  },
  "credits": { "creditsToCharge": 1, "creditsCharged": 1 },
  "response": {
    "page": 1,
    "organicResults": [
      {
        "position": 1,
        "title": "8 Easy-to-Use Project Management Software Platforms for ...",
        "link": "https://ones.com/blog/8-easy-to-use-project-management-software-platforms-for-small-teams/?primary_category=knowledge",
        "snippet": "1 day ago — ONES.com came out on top for teams that need Jira-like power without the complexity, while Trello and Asana hold their ground for basic, visual ...",
        "page": 1
      }
    ],
    "peopleAlsoAsk": [
      { "question": "Does Microsoft Teams have a project management tool?" },
      {
        "question": "What is the best project management software for a small construction company?"
      }
    ]
  }
}
task.statusstring
依次为 QUEUED、PROCESSING，最终为附带回答的 COMPLETED 或附带 error 的 FAILED。
credits.creditsChargedinteger
已完成任务扣除的积分。失败的任务为 0。
response.organicResultsarray
页面上的搜索结果：position、title、link、snippet 和 page。
response.peopleAlsoAskarray
Google 在页面上列出的相关问题。

搜索 Reddit

向 REDDIT 发送 query 查找帖子，加上 subreddit 则在一个社区内查找；发送帖子 url 则读取该帖子及第一页评论。

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskType": "REDDIT",
    "payload": {
      "query": "best mechanical keyboard for programming",
      "country": "US"
    }
  }'

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

JSON
{
  "success": true,
  "task": {
    "id": "fe0a46a2-7bf1-4cd0-8183-d299dc421c70",
    "taskType": "REDDIT",
    "status": "COMPLETED",
    "createdAt": "2026-10-02T15:47:44.384Z"
  },
  "credits": { "creditsToCharge": 1, "creditsCharged": 1 },
  "response": {
    "results": [
      {
        "url": "https://www.reddit.com/r/MechanicalKeyboardsUK/comments/1qz6da6/best_silent_mechanical_keyboard_for_programming/",
        "title": "Best silent mechanical keyboard for programming?",
        "postId": "1qz6da6",
        "preview": "I currently have a mechanical keyboard but I often wake up in the middle of the night and it is quite loud so I can't use my computer because …",
        "subreddit": "MechanicalKeyboardsUK"
      }
    ]
  }
}
payload.subredditstring
在一个 subreddit 内搜索，填写 r/ 之后的名称。
payload.urlstring
帖子地址 https://www.reddit.com/r/{subreddit}/comments/{postId}/…。读取帖子正文和第一页评论。
payload.commentSortstring
评论排序：top（默认）、new、controversial、old 或 qa。
response.resultsarray
匹配搜索的帖子：postId、title、url、subreddit 和 preview。
response.postobject
传入帖子 url 时返回：标题、正文、作者、得分和评论数。
response.commentsobject
第一页评论，约 20 到 25 条，含作者、正文、得分和层级。

获取结果

请求会立即返回 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"

价格

每个完成的任务消耗 1 个积分。

更多更新

接收最新消息

通过邮件接收产品更新。

RSS 订阅