AI 検索データ API クイックスタート

API キーを発行し、質問を送信してポーリングまたは Webhook で 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" }
  }'

Webhookで受信

{
  "task": {
    "id": "8f2c1e40-…",
    "taskType": "GEMINI",
    "status": "COMPLETED",
    "createdAt": "2026-07-17T04:12:00.000Z"
  },
  "credits": { "creditsToCharge": 1.25, "creditsCharged": 1.25 },
  "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 キーを用意する

無料アカウントを作り、ダッシュボードでキーを発行します。サーバーの環境変数 QUERYING_API_KEY に保存し、サーバーから使用します。新規アカウントは支払方法の登録前から 500 クレジットを利用できます。

2. 質問を送信する

以下のコマンドは国設定 JP で Gemini に質問します。質問は書いた言語のまま送られます。受付レスポンスの 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": "JP"
  }
}'

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. Webhook で結果を受け取る

送信 JSON に webhook.url を追加し、HTTPS の受信サーバーを用意します。文書の署名検証を適用し、初回とバックオフ付き再試行 4 回の合計最大 5 回の送信に対応します。再送された結果は task.id で重複排除します。

JSON

{
  "taskType": "GEMINI",
  "payload": {
    "prompt": "通勤におすすめのワイヤレスイヤホン",
    "country": "JP"
  },
  "webhook": {
    "url": "https://your-server.example.com/querying-webhook"
  }
}