
gid://shopify/p/exampleチェア・ナチュラルオークキーワード、画像、またはその両方で商品を検索できます。価格、評価、色、性別、配送などの条件で絞り込むことが可能です。
$ shop search 'oak chair' --price-max 37500 --currency JPY --ships-to JP$ shop search 'oak chair' \ --price-max 37500 --currency JPY --ships-to JP
{ "products": [ { "title": "Matilda Chair", "description": { "plain": "Solid oak dining chair with a curved…" }, "rating": { "value": 4.7, "count": 58 }, "price_range": { "min": { "amount": 30000, "currency": "JPY" }, "max": { … } }, "variants": [ { "seller": { "name": "VNTI" }, "price": { "amount": 30000, … }, "availability": { "available": true } } ] }, … ]}{ "products": [ { "title": "Matilda Chair", "description": { "plain": "Solid…" }, "rating": { "value": 4.7, … }, "price_range": { "min": { "amount": 30000, … }, … }, "variants": [ … ] }, … ]}
特定の商品に関する説明、オプション、画像、評価を取得。さらに、その商品を販売している各ストアでの価格もわかります。
$ shop catalog get '<product-id>' --select 'Color=Natural oak' \ --country JP --currency JPY$ shop catalog get '<product-id>' \ --select 'Color=Natural oak' \ --country JP --currency JPY
{ "product": { "title": "Matilda Chair", "description": { "plain": "Solid oak dining chair with a curved…" }, "rating": { "value": 4.7, "count": 58 }, "options": [ { "name": "Color", "values": [ { "label": "Natural oak", … }, … ] } ], "media": [ { "type": "image", "url": "https://cdn.shopify.com/…" } ], "variants": [ { "seller": { "name": "VNTI" }, "price": { "amount": 30000, … }, "availability": { "available": true } }, { "seller": { "name": "Kiln & Co." }, "price": { "amount": 32000, … }, "availability": { "available": true } } ] }}{ "product": { "title": "Matilda Chair", "description": { "plain": "Solid…" }, "rating": { "value": 4.7, "count": 58 }, "options": [ { "name": "Color", … } ], "media": [ { "type": "image", … } ], "variants": [ { "seller": { "name": "VNTI" } }, { "seller": { "name": "Kiln & Co." } } ] }}
最大 50 件の商品 ID または Shopifyストアのリンクを指定して、現在の価格、在庫、画像、チェックアウトリンクを確認できます。
$ shop catalog lookup '<link>' '<link>' --ships-to JP --currency JPY$ shop catalog lookup '<link>' \ '<link>' --ships-to JP \ --currency JPY
{ "products": [ { "title": "Matilda Chair", "price_range": { "min": { "amount": 30000, "currency": "JPY" }, "max": { … } }, "variants": [ { "seller": { "name": "VNTI" }, "price": { "amount": 30000, … }, "availability": { "available": true } }, { "seller": { "name": "Kiln & Co." }, "price": { "amount": 32000, … }, "availability": { "available": true } } ] }, … ]}{ "products": [ { "title": "Matilda Chair", "price_range": { "min": { … }, … }, "variants": [ { "seller": { "name": "VNTI" }, … }, … ] }, … ]}




gid://shopify/p/exampleチェア・ナチュラルオーク







いいえ、両者は連携して機能します。Catalog は商品検索インデックスであり、shop.dev の検索もこれを基盤としています。一方、shop.dev には Shop でログイン、Shop Pay でのチェックアウト、注文追跡などの機能が追加されています。検索機能のみが必要な場合はここから、エージェントでチェックアウトも処理する場合は shop.dev から始めてください。
お試しの段階では不要です。キーがなくても、最低水準のレート制限で検索機能は動作します。Dev Dashboard から Catalog API キーを取得するとこの制限が緩和されますが、本番環境では必須となります。
Shopifyには、数百万のマーチャントが販売する10億点以上の商品が揃っています。ベータ版のカタログには、Shopifyで販売していないブランドの商品も含まれます。これらの商品はデフォルトで非表示になっており、アメリカの買い物客にのみ表示されます。商品の購入は、リンク先の各ブランドのウェブサイトで行われます。詳しくはこちら (新しいタブで開く)。
Shopifyマーチャントの商品は、ストアの最新の価格と在庫を反映しています。Shopify を利用していないブランドの商品は、それぞれのウェブサイトからデータを読み取るため、価格や出品状況がサイトと異なる場合があります。
いいえ。結果をキャッシュしたり、マーチャントの画像を再ホストしたりしないでください。必要なときに最新のデータをリクエストし、レスポンスの URL から画像を表示するようにしてください。テストには架空のデータを使用してください。