Geminiの回答から商品と場所も取得できます

GEMINIの結果に、Geminiが回答で表示する商品カードと場所が含まれるようになりました。

変更点

• shoppingCards: Geminiが表示する商品カードです。商品名、順位、価格、販売店、評価、レビュー数、サムネイル、Googleの商品ページへのproductLinkが入ります。
• inlineProducts: 回答の文中でリンクされた商品で、商品名、順位、productLinkが入ります。
• map: 場所についての質問でGeminiが薦める場所で、住所、座標、電話番号、ウェブサイト、Googleマップのリンク、評価、カテゴリが入ります。

仕組み

Geminiに何を買うか、どこへ行くかを尋ねると、答えの多くは本文の外にあります。価格付きの商品カードの列や、地図上の場所の一覧です。これらがtextの横に構造化されたフィールドとして、Geminiの表示順に入るため、positionでどの商品や場所が先に出たかがわかります。

priceは{value, currency, raw}の形なので、販売店ごとの価格を比べやすくなります。場所にはplaceId、addressとlatitudeとlongitudeを含むlocation、評価、レビュー数、提供元を含むreviewsがあります。商品カードの名前はtextにも残るため、回答本文で言及を数える集計も同じ数値のままです。

活用例

• 自社の商品がGeminiの商品カードに、何番目に、いくらで表示されるかを追跡します。
• 自社のカテゴリで、Geminiが購入者をどの販売店に案内しているかを確認します。
• 街ごとに、Geminiが薦めるクリニック、飲食店、店舗とその評価を確認します。

リクエストを送る

API キーを Authorization ヘッダーに入れてリクエストを送ります。

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": "Best ramen near me",
      "country": "US",
      "location": "East Village, New York"
    }
  }'

リクエストのフィールド

taskTypestring必須

実行するエンジン。CHATGPT や GOOGLE などを指定します。

payload.promptstring必須

ユーザーがチャットに入力するとおりに書いた質問。最大100,000文字。

payload.countrystring

質問する市場の2文字の国コード。US、KR、JP など。既定値は US。

payload.locationstring

country 内の場所。駅、地区、住所など最大200文字。エンジンはその場所にいるユーザーへの回答を返します。CHATGPT、GEMINI、GOOGLE、AIMODE、GOOGLE_SERP で使えます。

payload.include.markdownboolean

true にすると、見出し、リスト、表、リンクを保った markdown が加わります。

レスポンス

完了したタスクはこの形で届きます。長さを抑えて抜粋しています。

{
  "success": true,
  "task": {
    "id": "685aad4a-3191-4215-9d2a-93ada8376185",
    "taskType": "GEMINI",
    "status": "COMPLETED",
    "createdAt": "2026-10-02T15:51:49.105Z"
  },
  "credits": { "creditsToCharge": 1, "creditsCharged": 1 },
  "response": {
    "text": "**[IPPUDO NY](https://maps.google.com/?cid=13390953617500975094)** · ★ 4.4 (5,519) · Restaurant · 65 4th Ave, New York, NY 10003\n…",
    "map": [
      {
        "position": 4,
        "name": "IPPUDO NY",
        "category": "Restaurant",
        "location": {
          "address": "65 4th Ave, New York, NY 10003",
          "latitude": 40.730948,
          "longitude": -73.990287
        },
        "reviews": [
          { "count": 5519, "rating": 4.4, "providerName": "Google" }
        ],
        "phoneNumber": "+1 212-388-0088",
        "url": "https://www.ippudous.com/east-village",
        "mapsUrl": "https://maps.google.com/?cid=13390953617500975094"
      }
    ],
    "location": {
      "name": "East Village, Manhattan Community Board 3, Manhattan, New York County, New York, 10003, United States",
      "query": "East Village, New York",
      "latitude": 40.72927,
      "longitude": -73.98736,
      "precision": "neighbourhood"
    }
  }
}

response.maparray

回答が勧めた場所。名前、住所、座標、評価、業種、地図リンク。

response.shoppingCardsarray

回答とともに表示された商品カード。商品名、価格、販売店、評価、商品リンク。

response.inlineProductsarray

回答の文中でリンクされた商品名。position と productLink が入ります。

response.locationobject

回答に使われた場所。query、name、latitude、longitude、precision。

結果を受け取る

リクエストすると status が QUEUED のタスクがすぐに返ります。status が COMPLETED か FAILED になるまで GET /v1/async/task/{id} で取得するか、webhook.url を指定して同じ task、credits、response をサーバーで受け取ります。結果はタスクの完了から24時間取得できます。

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

料金

料金はこれまでどおり完了したタスク1件につき1クレジットで、商品と場所も含まれます。