메인 콘텐츠로 건너뛰기
taskType이 엔진을 고릅니다. 모든 태스크는 같은 방식으로 제출하고, 모든 결과는 같은 결과 객체로 돌아옵니다. 엔진마다 달라지는 것은 그 안의 response 객체뿐입니다.

모든 태스크의 공통 부분

GET /v1/async/task/{id}는 모든 엔진에서 같은 결과 객체를 반환합니다. success, task(id, 상태, 메타데이터), credits, 그리고 태스크가 끝나면 response 또는 error입니다. 수명 주기는 비동기 태스크를, 푸시 전달은 웹훅을 참고하세요. 모든 답변 엔진은 답변을 response.text에, 인용한 페이지를 response.sources에 담습니다. sources는 { position, url, label }에 엔진별 필드가 더해진 배열입니다. 예외는 Google AI 개요로, 개요가 검색 결과 객체 안의 response.aioverview에 들어 있습니다.

답변 엔진

SERP

WEB_SCRAPE: url 필수. 공개 페이지나 PDF 하나, 2,048자 이하. render는 스크립트가 실행된 뒤 브라우저에서 읽고, maxAge는 최대 7일 전 캐시를 받아들입니다. COMMERCE_SERP: site 필수. US는 amazon, walmart, target, ebay, aliexpress, google_shopping, sephora, ulta, KR은 coupang, oliveyoung, 11st, lotteon, musinsa, kurly, JP는 rakuten, yahoo_shopping, qoo10, IN은 flipkart, myntra, nykaa, DE는 zalando. query: 필수, 1-500자. country: 선택, 기본값은 쇼핑몰의 국가. limit: 선택, 정수 1-40, 기본값 20. COMMERCE_PRODUCT: url 필수. US는 amazon, walmart, target, sephora, ulta, KR은 11st, lotteon, musinsa, kurly, oliveyoung, JP는 rakuten, yahoo_shopping, qoo10, IN은 flipkart, myntra, nykaa, DE는 zalando의 상품 페이지이며 2,048자 이하. country: 선택, 기본값은 쇼핑몰의 국가. WEB_SCRAPE: url 필수. 공개 페이지나 PDF 하나, 2,048자 이하. render는 스크립트가 실행된 뒤 브라우저에서 읽고, maxAge는 최대 7일 전 캐시를 받아들입니다. Search와 Pro Search는 별도 엔드포인트 POST /v1/search에서 실행되고 같은 응답으로 결과를 돌려줍니다. 검색 한 번에 0.5크레딧, Pro Search는 2크레딧입니다. 가격은 완료된 태스크 기준입니다. 예약, 청구, 부가 기능은 크레딧과 한도에서 설명합니다.

엔진이 읽는 payload 필드

다음 목록의 엔진에서는 검증이 prompt 또는 query가 1~100,000자로 들어 있으면 태스크를 받습니다(그렇지 않으면 400 VALIDATION_ERROR). 각 엔진은 한 필드를 먼저 읽고 없으면 다른 필드로 대체하므로, 다른 키로 보낸 요청도 실행됩니다.
  • CHATGPT, GEMINI, PERPLEXITY, COPILOT, BING_AIMODE, META_AI, QWEN, DOUBAO, BAIDU_WENXIN, BING_SEARCH는 prompt, 그다음 query를 읽습니다.
  • GOOGLE_AIO, GOOGLE_AIMODE, GOOGLE_SERP, GOOGLE_PLACES, GOOGLE_NEWS, NAVER_AI_BRIEF, NAVER_AI_TAB, NAVER_SERP, BAIDU_AI_SEARCH는 query, 그다음 prompt를 읽습니다.
  • BRAVE_SEARCH는 query, 그다음 prompt를 읽습니다.
둘 다 보내면 먼저 읽는 필드가 이깁니다. 읽는 필드 열은 각 엔진 페이지가 문서화한 필드입니다.

허용되는 별칭

아래 이름은 제출할 때 받아들이며 정식 taskType으로 실행됩니다. 새 코드에서는 정식 이름을 보내세요. GOOGLE과 AIMODE는 GOOGLE_AIO와 GOOGLE_AIMODE의 이전 이름입니다. 태스크는 제출할 때 보낸 이름으로 응답하고, 사용량과 모니터, 리포트에는 두 엔진이 GOOGLE과 AIMODE로 표시됩니다. 비공개 엔진은 403 ENGINE_PRIVATE로 거절됩니다.

실시간 목록

GET /v1/capabilities는 API 키 없이 호출할 수 있으며, 공개된 모든 taskType을 별칭, 엔드포인트, 크레딧, 필수·선택 입력 필드, state와 include.html 지원 여부, 국가 정책, 최소 예시 payload와 함께 반환합니다. 각 규칙을 실제로 적용하는 코드에서 만들어지므로 엔진과 국가 선택 UI를 구성할 때 사용하세요.
응답 스키마는 API 레퍼런스를 참고하세요.

요청 옵션