> ## Documentation Index
> Fetch the complete documentation index at: https://docs.querying.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# AI 搜索回答与引用数据 API

> 用于观测面向消费者的 AI 搜索界面的数据基础设施，覆盖 ChatGPT、Perplexity、Gemini、Google AI 概览等。

querying.ai 是回答一个问题的 API：\*\*当你向 AI 引擎提问时，它会怎么回答？\*\*你针对某个引擎提交提示词，
我们返回该引擎的回答以及它引用的来源。

它遵循回答引擎 API 的标准异步任务协议，因此现有客户端通常只需更换 base URL 和 API 密钥即可迁移，
无需修改代码。请参阅[迁移现有集成](/zh/migrating)。

## 工作原理

所有请求都是**异步**的。你提交任务后，任务进入队列，由 worker 查询目标引擎并提取结果，结果通过
webhook 推送给你，或由你轮询获取。

<Steps>
  <Step title="提交任务">
    携带 `taskType` 和 `payload` 调用 `POST /v1/async/task`。你会立即拿到任务 `id`，状态为 `QUEUED`。
  </Step>

  <Step title="查询引擎">
    worker 领取任务，查询引擎，并提取回答文本、来源以及引擎特有的附加数据。
  </Step>

  <Step title="获取结果">
    如果提供了 `webhook.url`，我们会把结果 POST 到该地址。否则请轮询 `GET /v1/async/task/{id}`，
    直到 `status` 变为 `COMPLETED` 或 `FAILED`。
  </Step>
</Steps>

## 返回内容

无论哪个引擎，每个结果的核心都是同样的结构：

<ResponseField name="text" type="string">
  引擎回答的纯文本。
</ResponseField>

<ResponseField name="sources" type="array">
  引擎附在回答上的引用，包含 `position`、`url`，通常还有 `label`。
</ResponseField>

各引擎会在此基础上加入自己的字段：Google 返回完整的 SERP 信封；ChatGPT 和 Perplexity 可以返回它们展开的
搜索查询；Naver 的 AI 标签页会返回它展示的购物面板。各引擎的结构请参阅[引擎](/zh/engines/overview)。

## Base URL

```
https://api.querying.ai
```

除 `/health` 和 `/ready` 外，所有端点都需要 [Bearer 令牌](/zh/authentication)。

<Card title="从这里开始" icon="rocket" href="/zh/quickstart">
  提交你的第一个任务，五分钟内拿到结果。
</Card>

## 了解产品

* [AI 回答采集](https://querying.ai/zh/answers)
* [来源证据分析](https://querying.ai/zh/source-influence)
* [GEO 监测](https://querying.ai/zh/monitors)
* [API 入门指南](https://querying.ai/zh/guides/quickstart)