更新情報2026年10月22日新機能

Commerce Search と Commerce Product が Google ショッピングに対応しました

API

COMMERCE_SERP と COMMERCE_PRODUCT のチップが付いた Google Shopping、cerave moisturizing cream の検索で1〜3位の商品と価格、評価、ストア、1位の商品を扱う4ストアの価格（Target の4.19ドルから CVS Pharmacy の7.49ドルまで）

Commerce Search で米国の Google ショッピングタブを検索し、Commerce Product で商品を読むと、Google が示す各ストアの価格、在庫、商品ページを受け取れます。

得られる結果

COMMERCE_SERP の site: "google_shopping"：1つのタスクが米国の Google ショッピングタブを検索し、Google の順に最大40件の商品を返します。各商品に rank、productId、title、price、url が入ります。
seller：商品カードに表示されるストア名。Target、Ulta Beauty、Walmart などが入り、カードに表示されていれば rating、reviewCount、imageUrl も入ります。
COMMERCE_PRODUCT は検索結果の url で商品を読み、title、price、seller、inStock、rating、images、specs を返します。
offers：Google がその商品に示すすべてのストア。各ストアに seller、title、price、currency、inStock と、そのストアの商品ページの url が入ります。

仕組み

検索ごとに、米国で検索語に対して Google が表示するショッピングタブ（google.com/search?udm=28 のページ）を読みます。商品の url はその検索結果ページを開き、# の後ろに商品 ID と商品名を持ちます。COMMERCE_PRODUCT はこの値で同じ商品を見つけます。

商品の読み取りでは検索結果ページを開いて商品をクリックし、Google が表示するパネルのストア、説明、仕様、写真を読みます。商品の price、listPrice、seller、inStock は、Google が最安値として示す最初のストアの値です。Google は広い検索語の結果を1日の間に入れ替えるため、商品をまず検索語で、次に商品名で探します。

reviewCount には Google が表示する正確な件数が1,000まで入ります。それより多い件数を Google は17Kのように短く表示します。

活用例

自社商品の Google 最安値をどのストアが取っているか、ほかのストアがどれだけ高いかを確認できます。
カテゴリの検索語で Google ショッピングが上位に出す商品を毎日追跡し、同じ検索語の Amazon、Walmart、Target の順位と並べて見られます。
1つの商品を扱う全ストアの商品ページを集め、Target、Walmart、Ulta のページは Commerce Product で続けて読めます。

リクエストを送る

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": "COMMERCE_SERP",
    "payload": {
      "site": "google_shopping",
      "query": "cerave moisturizing cream",
      "limit": 10
    }
  }'

リクエストのフィールド

taskTypestring必須: 実行するエンジン。CHATGPT や GOOGLE などを指定します。
payload.sitestring必須: 検索する EC サイト。amazon、coupang、rakuten などを指定します。21の値はエンジンの説明にあります。
payload.querystring必須: 買い物客が EC サイトの検索窓に入力するとおりに書いた検索語。1〜500文字。
payload.countrystring: EC サイトの国。amazon は US、coupang は KR です。省略するとこの値が既定値になります。
payload.limitinteger: 返す商品の数、1〜40。既定値は20。
webhook.urlstring: サーバーの HTTPS アドレス。タスクが完了した瞬間に結果をここへ送ります。

レスポンス

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

JSON

{
  "success": true,
  "task": {
    "id": "b02ec42c-2ea1-4a6f-ba70-1b3099b8ceff",
    "taskType": "COMMERCE_SERP",
    "status": "COMPLETED",
    "createdAt": "2026-10-23T01:32:45.682Z"
  },
  "credits": { "creditsToCharge": 3, "creditsCharged": 3 },
  "response": {
    "site": "google_shopping",
    "query": "cerave moisturizing cream",
    "country": "US",
    "returnedCount": 10,
    "products": [
      {
        "rank": 1,
        "productId": "16245040360969784676",
        "title": "CeraVe Moisturizing Cream",
        "url": "https://www.google.com/search?q=cerave+moisturizing+cream&udm=28&gl=us&hl=en#product=16245040360969784676&title=CeraVe+Moisturizing+Cream",
        "price": 4.19,
        "currency": "USD",
        "seller": "Target",
        "rating": 4.7
      },
      {
        "rank": 2,
        "productId": "5074307725217910967",
        "title": "CeraVe Moisturizing Cream Pump",
        "url": "https://www.google.com/search?q=cerave+moisturizing+cream&udm=28&gl=us&hl=en#product=5074307725217910967&title=CeraVe+Moisturizing+Cream+Pump",
        "price": 17.99,
        "currency": "USD",
        "seller": "Target",
        "rating": 4.7
      },
      "…"
    ]
  }
}

task.statusstring: QUEUED、PROCESSING を経て、回答付きの COMPLETED か error 付きの FAILED で終わります。
credits.creditsChargedinteger: 完了したタスクに請求されたクレジット。失敗したタスクは0です。
response.returnedCountinteger: products に入っている商品の数。
response.productsarray: Google の順に並んだ商品。rank、productId、title、url、price、currency、seller と、商品カードに表示されていれば rating、reviewCount、imageUrl が入ります。

結果を受け取る

リクエストすると 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"

商品を読む

検索結果の商品 url を COMMERCE_PRODUCT に渡します。上の1位の商品を読んだ結果を、長さを詰めて示します。

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskType": "COMMERCE_PRODUCT",
    "payload": {
      "url": "https://www.google.com/search?q=cerave+moisturizing+cream&udm=28&gl=us&hl=en#product=16245040360969784676&title=CeraVe+Moisturizing+Cream"
    }
  }'

taskTypestring必須: 実行するエンジン。CHATGPT や GOOGLE などを指定します。
payload.urlstring必須: google_shopping の Commerce Search 結果にある商品の url。検索結果ページを開き、# の後ろに商品 ID と商品名を持ちます。

JSON

{
  "success": true,
  "task": {
    "id": "9ee619d2-c87f-47ab-93cd-215ef3671734",
    "taskType": "COMMERCE_PRODUCT",
    "status": "COMPLETED",
    "createdAt": "2026-10-23T01:36:00.797Z"
  },
  "credits": { "creditsToCharge": 3, "creditsCharged": 3 },
  "response": {
    "site": "google_shopping",
    "country": "US",
    "url": "https://www.google.com/search?q=cerave+moisturizing+cream&udm=28&gl=us&hl=en#product=16245040360969784676&title=CeraVe+Moisturizing+Cream",
    "productId": "16245040360969784676",
    "title": "CeraVe Moisturizing Cream",
    "price": 4.19,
    "currency": "USD",
    "inStock": true,
    "seller": "Target",
    "rating": 4.7,
    "images": [
      "https://encrypted-tbn3.gstatic.com/shopping?q=tbn:ANd9GcTdoC3RoTxQCkmpSUypL2HqkAR300eBZ_E3W2NCfz2MP4541LroFfQ8ZzNM2XIpm_xS_3c4dZU4_LMYtqQjE89N-Z8wH4Y_gA",
      "…"
    ],
    "specs": [
      { "name": "Benefit", "value": "Moisturizing" },
      { "name": "Form", "value": "Cream" },
      "…"
    ],
    "offers": [
      {
        "seller": "Target",
        "title": "CeraVe Moisturizing Face & Body Cream for Normal to Dry Skin – 1.89 fl oz",
        "url": "https://www.target.com/p/cerave-moisturizing-face-38-body-cream-for-normal-to-dry-skin-8211-1-89-fl-oz/-/A-86467779",
        "price": 4.19,
        "currency": "USD",
        "inStock": true
      },
      {
        "seller": "Ulta Beauty",
        "title": "CeraVe Moisturizing Cream Body and Face Moisturizer - 1.8 oz",
        "url": "https://www.ulta.com/p/moisturizing-cream-body-face-moisturizer-xlsImpprod3530069?sku=2532670",
        "price": 6.99,
        "currency": "USD",
        "inStock": true
      },
      "…"
    ]
  }
}

response.pricenumber: ページが最初に表示する商品を、クーポンと送料の前に買う価格。単位は currency（ISO 4217）。listPrice は price より高いときにページが取り消し線で示す通常価格です。
response.offersarray: Google がその商品に示すストアを Google の順に。seller、title、price、currency とストアの商品ページの url、ストアの行に表示されていれば listPrice と inStock が入ります。最初のストアが Google の最安値です。

エラー

VALIDATION_ERRORHTTP 422: site が21のサイトの外にあるか、query が空か500文字を超えるか、limit が1〜40の外にあるか、payload に別のフィールドがあります。details に該当するフィールドが入ります。
VALIDATION_ERRORHTTP 422: url がない、2,048文字を超える、18サイトの商品ページの外にある、または payload に url と country 以外のフィールドがあります。details に該当するフィールドが入ります。
REGION_UNSUPPORTEDHTTP 422: country が EC サイトの国と異なります。例: amazon に KR。
MISSING_API_KEYHTTP 401: Authorization ヘッダーが欠けているか、キーが誤っている、期限切れ、または無効化済みです。
INSUFFICIENT_CREDITSHTTP 402: 残高がタスクの料金を下回っています。クレジットを追加するかプランを上げてから、もう一度送ってください。

料金

完了した検索と完了した商品の読み取りごとに、ほかの EC サイトと同じく3クレジットを使います。クレジットはタスクの完了時に差し引かれます。

ほかの更新

API2026年10月22日新機能
ChatGPTがページをどこまで読むかスコアで確認できます
ページの URL を GEO Score に送ると、ChatGPT 検索がそのページの内容をどれだけ持っているか、ChatGPT が直接開いたときに何を受け取るか、取りこぼした内容ごとの理由と直し方を受け取れます。
API2026年10月22日新機能
Commerce Productが登場しました
Amazon、Walmart、Sephora、Olive Young、楽天、Zalandoなど17のECサイトの商品ページURLを渡すと、価格、在庫、商品画像と説明画像、仕様、オプションを同じ形で受け取れます。

製品の更新をメールでお届けします。

RSS フィード