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

API 키 발급부터 한국어 질문 제출, 결과 폴링과 웹훅까지. Gemini 예시로 querying.ai의 첫 AI 답변을 수집하세요.

태스크 제출

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer vt_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "taskType": "GEMINI",
    "payload": { "prompt": "best wireless earbuds 2026" },
    "webhook": { "url": "https://yours.app/hooks/querying" }
  }'

웹훅 수신

{
  "task": {
    "id": "8f2c1e40-…",
    "taskType": "GEMINI",
    "status": "COMPLETED",
    "createdAt": "2026-07-17T04:12:00.000Z"
  },
  "credits": { "creditsToCharge": 1, "creditsCharged": 1 },
  "response": {
    "text": "The best wireless earbuds in 2026 are …",
    "sources": [
      { "position": 1,
        "url": "https://example.com/review",
        "label": "Best earbuds, reviewed" }
    ],
    "timing": { "totalMs": 7400 }
  }
}

1. API 키 준비

무료 계정을 만들고 대시보드의 API 키 화면에서 키를 발급합니다. 키는 서버 환경 변수 QUERYING_API_KEY에 저장해 서버에서만 사용합니다. 새 계정은 결제 수단을 등록하기 전부터 500크레딧으로 시작합니다.

2. 질문 제출

아래 명령은 Gemini에 한국어 질문을 KR 국가 설정으로 제출합니다. 질문은 원하는 언어로 작성하면 그대로 전달됩니다. 응답의 task.id를 다음 단계에 사용합니다.

cURL

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·PROCESSING이면 간격을 두고 다시 확인하고, COMPLETED이면 response를 읽습니다. FAILED이면 오류 정보를 확인합니다. 공개 폴링은 완료 후 24시간 안에 수행해야 합니다.

cURL

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

4. 웹훅으로 자동 수신

접수 JSON에 webhook.url을 추가하면 종료 결과를 서버로 받습니다. HTTPS 수신기를 준비하고 문서의 서명 검증과 재시도 규칙을 적용하세요. 재전달된 결과는 task.id로 식별해 한 번만 처리합니다.

JSON

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