AI 검색 데이터 API 시작 가이드

1. API 키 준비

무료 계정을 만들고 대시보드의 API 키 화면에서 키를 발급합니다. 키는 서버 환경 변수 QUERYING_API_KEY에 저장하고 브라우저 코드나 공개 저장소에 넣지 마세요. 새 계정은 카드 등록 없이 2,000크레딧으로 시작합니다.

2. 질문 제출

아래 명령은 Gemini에 한국어 질문을 KR 국가 설정으로 제출합니다. 국가 코드가 질문을 번역하지 않으므로 질문은 원하는 언어로 작성하세요. 응답의 task.id를 다음 단계에 사용합니다.

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "taskType": "GEMINI",
  "payload": {
    "prompt": "출퇴근용 무선 이어폰 추천",
    "country": "KR"
  }
}'

3. 완료 결과 확인

TASK_ID를 접수 응답의 ID로 바꿉니다. QUEUED·RUNNING이면 간격을 두고 다시 확인하고, COMPLETED이면 response를 읽습니다. FAILED는 성공한 빈 답변으로 처리하지 말고 오류 정보를 확인하세요. 공개 폴링은 완료 후 24시간 안에 수행해야 합니다.

curl https://api.querying.ai/v1/async/task/TASK_ID \
  -H "Authorization: Bearer $QUERYING_API_KEY"

4. 웹훅으로 자동 수신

접수 JSON에 webhook.url을 추가하면 종료 결과를 서버로 받습니다. HTTPS 수신기를 준비하고 문서의 서명 검증과 재시도 규칙을 적용하세요. 같은 작업의 재전달은 task.id로 구분해 중복 처리하지 않습니다.

{
  "taskType": "GEMINI",
  "payload": {
    "prompt": "출퇴근용 무선 이어폰 추천",
    "country": "KR"
  },
  "webhook": {
    "url": "https://your-server.example.com/querying-webhook"
  }
}

5. 다른 엔진과 반복 측정으로 확장

엔진 상세에서 taskType·prompt/query·응답 구조를 확인한 뒤 확장하세요. 잔액 부족이나 동시 요청 한도 초과를 무한 재시도하지 말고 원인을 처리합니다. 브랜드 노출을 반복 측정하려면 Monitors에 같은 프롬프트 집합을 저장하세요.

함께 살펴보기