> ## 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

> ChatGPT, Perplexity, Gemini, Google AI 개요 등 소비자용 AI 검색 화면을 관측하는 데이터 인프라입니다.

querying.ai는 한 가지 질문에 답하는 API입니다. **AI 엔진에 무언가를 물으면 무엇이라고 답하는가?**
특정 엔진을 대상으로 프롬프트를 보내면, 그 엔진의 답변과 답변이 인용한 출처를 돌려드립니다.

답변 엔진 API의 표준 비동기 태스크 계약을 따르므로, 기존 클라이언트는 보통 base URL과 API 키만
바꾸면 코드 수정 없이 옮겨올 수 있습니다. [기존 연동 마이그레이션](/ko/migrating)을 참고하세요.

## 동작 방식

모든 요청은 **비동기**입니다. 태스크를 제출하면 큐에 쌓이고, 워커가 대상 엔진에 질의해 결과를
추출합니다. 결과는 webhook으로 받거나 폴링으로 가져갑니다.

<Steps>
  <Step title="태스크 제출">
    `taskType`과 `payload`를 담아 `POST /v1/async/task`를 호출합니다. 태스크 `id`가 즉시
    `QUEUED` 상태로 반환됩니다.
  </Step>

  <Step title="엔진 질의">
    워커가 태스크를 가져가 엔진에 질의하고, 답변 텍스트와 출처, 엔진별 추가 데이터를 추출합니다.
  </Step>

  <Step title="결과 수집">
    `webhook.url`을 지정했다면 결과를 그 주소로 POST합니다. 지정하지 않았다면 `status`가
    `COMPLETED` 또는 `FAILED`가 될 때까지 `GET /v1/async/task/{id}`를 폴링하세요.
  </Step>
</Steps>

## 받게 되는 결과

엔진과 관계없이 모든 결과의 핵심은 같은 형태입니다.

<ResponseField name="text" type="string">
  엔진의 답변을 일반 텍스트로 담습니다.
</ResponseField>

<ResponseField name="sources" type="array">
  엔진이 답변에 붙인 인용입니다. `position`, `url`, 그리고 대개 `label`을 포함합니다.
</ResponseField>

엔진마다 여기에 고유 필드가 더해집니다. Google은 SERP 전체 봉투를 반환하고, ChatGPT와
Perplexity는 내부적으로 실행한 검색어를 반환할 수 있으며, 네이버 AI 탭은 함께 보여준 쇼핑
패널을 반환합니다. 엔진별 형태는 [엔진](/ko/engines/overview)에서 확인하세요.

## Base URL

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

`/health`와 `/ready`를 제외한 모든 엔드포인트에는 [Bearer 토큰](/ko/authentication)이 필요합니다.

<Card title="여기서 시작하세요" icon="rocket" href="/ko/quickstart">
  첫 태스크를 제출하고 5분 안에 결과를 받아 보세요.
</Card>

## 제품 둘러보기

* [AI 답변 수집](https://querying.ai/ko/answers)
* [출처 근거 분석](https://querying.ai/ko/source-influence)
* [GEO 모니터링](https://querying.ai/ko/monitors)
* [API 시작 가이드](https://querying.ai/ko/guides/quickstart)