> ## Documentation Index > Fetch the complete documentation index at: https://docs.querying.ai/llms.txt > Use this file to discover all available pages before exploring further. # Commerce Product API (COMMERCE_PRODUCT) > Amazon、Walmart、Target、Sephora、Ulta、Olive Young、11st、Musinsa、Kurly、楽天市場、Flipkart、Zalando などのストアの商品ページを 1 つ読み取り、価格、在庫、販売者、評価、画像、仕様、オプションを同じ形式で受け取ります。 ストアの商品ページを 1 つ読み取り、商品情報を非同期タスク API で JSON として受け取ります。ページの `url` を渡すと URL からストアを選び、どのストアも同じフィールドを返します。完了した読み取り 1 件につき **3 クレジット**です。 ## リクエスト ```bash theme={"theme":"css-variables"} 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" } }' ``` タスクを送信したあと、`GET /v1/async/task/{id}` をポーリングするか Webhook で受け取ります。[非同期タスク](/ja/concepts/async-tasks.md)を参照してください。 ## パラメータ * `url`: 必須。下の表のストアの商品ページで、2,048 文字以内です。[Commerce Search](/ja/engines/commerce-serp.md) がこれらのストアで返す商品の `url` はそのまま渡せます。ただし、Yahoo!ショッピングの LOHACO のページ（`lohaco.yahoo.co.jp`）は受け付けません。トラッキングコードなど結果に影響しないパラメータは読み取り前に取り除きます。 * `country`: 任意。デフォルトはストアの国です。ほかの国は `422 REGION_UNSUPPORTED` で拒否されます。 | `site` | 商品ページ | `country` | | - | - | - | | `amazon` | `amazon.com/dp/{ASIN}` | `US` | | `walmart` | `walmart.com/ip/{name}/{id}` | `US` | | `target` | `target.com/p/{name}/-/A-{TCIN}` | `US` | | `sephora` | `sephora.com/product/{name}-P{id}` | `US` | | `ulta` | `ulta.com/p/{name}-{id}` | `US` | | `11st` | `11st.co.kr/products/{id}` | `KR` | | `lotteon` | `lotteon.com/p/product/{id}` | `KR` | | `musinsa` | `musinsa.com/products/{id}` | `KR` | | `kurly` | `kurly.com/goods/{id}` | `KR` | | `oliveyoung` | `oliveyoung.co.kr/store/goods/getGoodsDetail.do?goodsNo={id}` | `KR` | | `rakuten` | `item.rakuten.co.jp/{shop}/{item}/` | `JP` | | `yahoo_shopping` | `store.shopping.yahoo.co.jp/{store}/{item}.html` | `JP` | | `qoo10` | `qoo10.jp/g/{id}` | `JP` | | `flipkart` | `flipkart.com/{name}/p/{itm}?pid={pid}` | `IN` | | `myntra` | `myntra.com/{category}/{brand}/{name}/{id}/buy` | `IN` | | `nykaa` | `nykaa.com/{name}/p/{id}` | `IN` | | `zalando` | `zalando.de/{name}-{sku}.html` | `DE` | | `google_shopping` | `google.com/search?q={query}&udm=28#product={productId}&title={title}` | `US` | Amazon の `/gp/product/{ASIN}` や 11st のモバイルページなど、同じページの別のアドレスも使えます。 ## レスポンス例 ```json theme={"theme":"css-variables"} { "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": 16.77, "listPrice": 18.96, "currency": "USD", "inStock": true, "seller": "Amazon.com", "rating": 4.7, "reviewCount": 149149, "images": ["https://m.media-amazon.com/images/I/61EidjXUBrL._SL1000_.jpg"], "description": "[ HYALURONIC ACID MOISTURIZER ] With hyaluronic acid, ceramides and MVE technology for 24 hour hydration.", "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": "Item Form", "value": "Cream" }, { "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", "Creams & Moisturizers", "Face Moisturizers"] } ``` ## 結果フィールド * `site`、`country`、`url`、`productId` は読み取ったページを示します。`url` は実際に読み取ったページです。`productId` はストア独自の商品 ID で（Amazon は ASIN、楽天市場は `shop:item`）、Commerce Search が返す ID と同じです。ただし、Nykaa で色やサイズの選択肢がある商品は、Commerce Search が選択肢 1 つの ID を、この読み取りは商品ページの ID を返します。 * `title` は常に含まれます。ほかのフィールドはページに表示されているときに含まれ、フィールドごとに値を返すストアは下の表のとおりです。 * `price` はページが最初に表示する商品を、クーポンと送料の前に購入する価格で、通貨は `currency`（ISO 4217）です。`listPrice` はページが取り消し線で示す通常価格で、`price` より高いときに含まれます。`inStock` はその商品の在庫の有無、`seller` は販売者です。 * `rating` は 5 段階評価で小数第 2 位までです。`reviewCount` はレビュー数です。 * `images` は商品の画像一覧にある写真の URL をページの順に最大 30 件含みます。11st と Lotte ON はメインの写真 1 枚のみ、Sephora は 2 枚までで、楽天市場と Yahoo!ショッピングでは出店者が画像一覧に載せたバナーやお知らせの画像も含まれます。`description` は段落ごとに 1 行のプレーンテキストで、最大 10,000 文字です。画像の中にしかない文字は含みません。 * `descriptionImages` は出店者の商品説明ページや Amazon の A+ コンテンツなど、商品説明にある画像の URL をページの順に最大 300 件含みます。出店者が説明に載せたバナーやお知らせの画像も含まれ、画像の中の文字は読み取りません。 * `specs` は商品詳細の `{ name, value }` の組を最大 100 件含みます。`options` はサイズや色などの選択肢を最大 20 件含み、選択肢ごとの `values` は最大 100 件です。ほかのフィールドはページが最初に開く選択肢のものです。`categories` は広いカテゴリから狭いカテゴリの順で、最大 10 階層です。`gtin` はページに記載された UPC、EAN、JAN です。 * `google_shopping` は [Commerce Search](/ja/engines/commerce-serp.md) が返した商品を読み取ります。`url` には検索語句、Google の商品 ID、商品名が入っています。同じ検索語句で Google ショッピングを再検索し、その検索語句で商品が表示されない場合は商品名で検索して商品パネルを開くため、ほかのストアより時間がかかります。`offers` は Google が表示する販売店の一覧で、Google が最安値と表示した販売店が先頭です。各販売店には `seller`、`title`（販売店での商品名）、`url`（販売店の商品ページ）、`price`、`listPrice`、`currency`、`inStock` が入ります。商品の `price`、`listPrice`、`seller`、`inStock` は先頭の販売店の値です。`reviewCount` は Google が正確な件数を表示する場合（1,000 件未満）のみ含まれます。検索語句と商品名のどちらでも商品が表示されない場合、タスクは `PAGE_UNAVAILABLE` で終了します。 * ストアが 404 または 410 で応答するページ（削除された商品など）は `PAGE_UNAVAILABLE` で終了し、メッセージにストアの応答が入ります。ほかの読み取り失敗は `ENGINE_NO_RESULT` です。課金は完了した読み取りごとです。 | フィールド | 値を返すストア | | - | - | | `title`, `price`, `currency`, `images` | すべて | | `brand` | 楽天市場以外のすべて | | `inStock` | Target、Sephora 以外のすべて | | `rating` | Lotte ON、Kurly、Zalando 以外のすべて | | `reviewCount` | Lotte ON、Zalando 以外のすべて | | `categories` | Sephora、Qoo10、Flipkart、Google ショッピング以外のすべて | | `description` | 11st、Qoo10 以外のすべて。Lotte ON、Musinsa、Olive Young は商品説明の大半を画像で表示するため、一部のページにだけあります。Flipkart と Zalando は検索エンジン向けに公開している短い要約を返します。 | | `descriptionImages` | Amazon、Ulta、11st、Lotte ON、Musinsa、Kurly、Olive Young、楽天市場、Yahoo!ショッピング、Qoo10 | | `specs` | Amazon、Walmart、Target、Ulta、Lotte ON、Musinsa、Kurly、Myntra、Nykaa、Google ショッピング | | `options` | Amazon、Walmart、Ulta、Musinsa、Kurly、Olive Young、楽天市場、Myntra、Nykaa、Zalando | | `seller` | Amazon、Walmart、Lotte ON、Kurly、楽天市場、Myntra、Nykaa、Google ショッピング | | `listPrice` | Amazon、Walmart、Target、Sephora、Musinsa、Kurly、Olive Young、Qoo10、Myntra、Nykaa、Google ショッピング | | `offers` | Google ショッピング | | `gtin` | Amazon、Walmart、Target、Ulta、Olive Young、楽天市場、Yahoo!ショッピング | ## 関連 * [Commerce Search](/ja/engines/commerce-serp.md) * [エンジン一覧](/ja/engines/overview.md) * [クレジットと上限](/ja/concepts/credits-and-limits.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.