Skip to main content
querying.ai는 한 가지 질문에 답하는 API입니다. AI 엔진에 무언가를 물으면 무엇이라고 답하는가? 특정 엔진을 대상으로 프롬프트를 보내면, 그 엔진의 답변과 답변이 인용한 출처를 돌려드립니다. 답변 엔진 API의 표준 비동기 태스크 계약을 따르므로, 기존 클라이언트는 보통 base URL과 API 키만 바꾸면 코드 수정 없이 옮겨올 수 있습니다. 기존 연동 마이그레이션을 참고하세요.

동작 방식

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

태스크 제출

taskType과 payload를 담아 POST /v1/async/task를 호출합니다. 태스크 id가 즉시 QUEUED 상태로 반환됩니다.
2

엔진 질의

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

결과 수집

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

받게 되는 결과

엔진과 관계없이 모든 결과의 핵심은 같은 형태입니다.
string
엔진의 답변을 일반 텍스트로 담습니다.
array
엔진이 답변에 붙인 인용입니다. position, url, 그리고 대개 label을 포함합니다.
엔진마다 여기에 고유 필드가 더해집니다. Google은 SERP 전체 봉투를 반환하고, ChatGPT와 Perplexity는 내부적으로 실행한 검색어를 반환할 수 있으며, 네이버 AI 탭은 함께 보여준 쇼핑 패널을 반환합니다. 엔진별 형태는 엔진에서 확인하세요.

Base URL

/health와 /ready를 제외한 모든 엔드포인트에는 Bearer 토큰이 필요합니다.

여기서 시작하세요

첫 태스크를 제출하고 5분 안에 결과를 받아 보세요.

제품 둘러보기