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

Commerce Productが登場しました

API

COMMERCE_PRODUCT のチップが付いた Commerce Product と、Amazon と Olive Young から読み取った商品カード2枚。商品画像、価格、評価、レビュー数、説明画像、仕様、オプションの数

Amazon、Walmart、Sephora、Olive Young、楽天、Zalandoなど17のECサイトの商品ページURLを渡すと、価格、在庫、商品画像と説明画像、仕様、オプションを同じ形で受け取れます。

得られる結果

COMMERCE_PRODUCT: 1つのタスクで1つの商品ページを読みます。米国、韓国、日本、インド、ドイツの17サイトに対応し、ページの url でサイトが決まります。
ページに表示されたとおりに、title、brand、currency とともに price と listPrice、さらに inStock、seller、rating、reviewCount を受け取れます。
images は商品ギャラリーです。descriptionImages は販売者の商品詳細ページや Amazon の A+ コンテンツなど、商品説明に入った画像をページの順に入れます。
description、specs、options、categories、gtin も、どのサイトでも同じフィールドで受け取れます。

対応サイト

米国（US）: Amazon amazon、Walmart walmart、Target target、Sephora sephora、Ulta ulta
韓国（KR）: Olive Young oliveyoung、11st 11st、Lotte ON lotteon、Musinsa musinsa、Kurly kurly
日本（JP）: 楽天市場 rakuten、Yahoo!ショッピング yahoo_shopping、Qoo10 qoo10
インド（IN）: Flipkart flipkart、Myntra myntra、Nykaa nykaa
ドイツ（DE）: Zalando zalando

仕組み

タスクごとにサイトの国から商品ページを読み、ページが最初に開く選択肢の値を返します。price はクーポンと送料の前に支払う価格で、options にはほかのサイズ、色、セットが入ります。

images はギャラリーの写真を最大30枚、descriptionImages は商品説明の画像をページの順に最大300枚入れます。説明画像は Amazon、Ulta、Olive Young、11st、Lotte ON、Musinsa、Kurly、楽天市場、Yahoo!ショッピング、Qoo10 から届きます。販売者が置いたバナーやお知らせも一緒に届き、画像内の文字は画像のまま残ります。

title、price、currency、images はすべてのサイトから届き、ほかのフィールドはページに表示されているときに届きます。フィールドごとの対応サイトはエンジンのドキュメントにあります。販売終了のように、サイトが削除済みのページとして答えると、タスクは PAGE_UNAVAILABLE で終わります。

活用例

Commerce Search の上位商品を、価格、在庫、販売元、オプションまで詳しく読みます。
Amazon、Olive Young、楽天市場で自社商品ページの価格、通常価格、在庫を毎日追跡します。
競合商品の商品画像と説明画像を集め、ブランドごとに同じ商品をどう見せているかを比べます。
仕様、オプション、説明画像をカタログや AI ショッピング回答の点検に使います。

リクエストを送る

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_PRODUCT",
    "payload": { "url": "https://www.amazon.com/dp/B00TTD9BRC" }
  }'

リクエストのフィールド

taskTypestring必須: 実行するエンジン。CHATGPT や GOOGLE などを指定します。
payload.urlstring必須: 17の EC サイトのいずれかの商品ページ、最大2,048文字。URL でサイトと国が決まります。
payload.countrystring: EC サイトの国。Amazon は US、Olive Young は KR です。省略するとこの値が既定値になります。
webhook.urlstring: サーバーの HTTPS アドレス。タスクが完了した瞬間に結果をここへ送ります。

レスポンス

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

JSON

{
  "success": true,
  "task": {
    "id": "3f0f65f4-bb08-492b-8652-7037fe7cba0d",
    "taskType": "COMMERCE_PRODUCT",
    "status": "COMPLETED",
    "createdAt": "2026-10-22T09:27:29.765Z"
  },
  "credits": { "creditsToCharge": 3, "creditsCharged": 3 },
  "response": {
    "site": "amazon",
    "country": "US",
    "url": "https://www.amazon.com/dp/B00TTD9BRC",
    "productId": "B00TTD9BRC",
    "title": "CeraVe Moisturizing Cream, Face & Body Moisturizer for Dry Skin, 19oz",
    "brand": "CeraVe",
    "price": 18.39,
    "currency": "USD",
    "inStock": true,
    "seller": "Amazon.com",
    "rating": 4.7,
    "reviewCount": 149176,
    "images": [
      "https://m.media-amazon.com/images/I/61EidjXUBrL._SL1000_.jpg",
      "https://m.media-amazon.com/images/I/61-Ut3jOyyL._SL1500_.jpg",
      "…"
    ],
    "descriptionImages": [
      "https://m.media-amazon.com/images/S/aplus-media-library-service-media/8c56d081-e316-4b57-9731-fcf4eda0821f.__CR0,0,1464,600_PT0_SX1464_V1___.jpg",
      "…"
    ],
    "specs": [
      { "name": "Brand Name", "value": "CeraVe" },
      { "name": "Skin Type", "value": "All, Dry, Sensitive" },
      "…"
    ],
    "options": [
      {
        "name": "Size",
        "values": [
          "8 Ounce",
          "16 Ounce (Pack of 1)",
          "19 Ounce (Pack of 1)",
          "…"
        ]
      }
    ],
    "categories": ["Beauty & Personal Care", "Skin Care", "Face", "…"]
  }
}

task.statusstring: QUEUED、PROCESSING を経て、回答付きの COMPLETED か error 付きの FAILED で終わります。
credits.creditsChargedinteger: 完了したタスクに請求されたクレジット。失敗したタスクは0です。
response.pricenumber: ページが最初に表示する商品を、クーポンと送料の前に買う価格。単位は currency（ISO 4217）。listPrice は price より高いときにページが取り消し線で示す通常価格です。
response.imagesarray: 商品ギャラリーの写真を、ページの順に最大30枚。
response.descriptionImagesarray: 販売者の商品詳細ページや Amazon の A+ コンテンツなど、商品説明の画像をページの順に最大300枚。
response.specsarray: 商品詳細の { name, value } の組を最大100件。options にはサイズや色などの選択肢が values とともに入ります。

結果を受け取る

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

エラー

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

料金

どのサイトでも、完了した商品ページの読み取り1件ごとに3クレジットを使います。クレジットはタスクの完了時に差し引かれます。

ほかの更新

API2026年10月21日新機能
20のECサイトの商品検索に対応しました
Amazon、Walmart、Coupang、Olive Young、楽天、Flipkart、Zalandoなど5か国20のECサイトで、検索語の商品ランキングを価格、評価、レビュー数とともに同じ形で受け取れます。
ChatGPT2026年10月21日新機能
ChatGPT のカード詳細パネルも受け取れます
ChatGPT のタスクで include.entityDetails をオンにすると、回答に出た商品、場所、ブランドのカードごとに ChatGPT が開く詳細パネルの本文、出典、画像を追加料金なしで受け取れます。

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

RSS フィード