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

1. API キーを準備する

無料アカウントを作成してダッシュボードでキーを発行します。キーは QUERYING_API_KEY 環境変数に保存してください。

2. 質問を送信する

Gemini に質問を送信し、受け付けられた 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": "JP"
  }
}'

3. 完了結果を取得する

QUEUED または RUNNING の間は間隔をあけて確認し、COMPLETED で response を読みます。FAILED は空の成功として扱いません。

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

4. Webhook で自動受信する

submission JSON に webhook.url を追加し、署名検証と task.id による重複排除を実装します。

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

5. エンジンと定期測定を追加する

各エンジンの taskType、入力フィールド、応答スキーマを確認してから拡張します。

関連機能