
gid://shopify/p/example椅子 · 天然橡木通过关键字、图片或结合两者查找产品。按价格、评分、颜色、适用性别、发货等条件进行筛选。
$ shop search 'oak chair' --price-max 25000 --currency USD --ships-to US$ shop search 'oak chair' \ --price-max 25000 --currency USD --ships-to US
{ "products": [ { "title": "Matilda Chair", "description": { "plain": "Solid oak dining chair with a curved…" }, "rating": { "value": 4.7, "count": 58 }, "price_range": { "min": { "amount": 20000, "currency": "USD" }, "max": { … } }, "variants": [ { "seller": { "name": "VNTI" }, "price": { "amount": 20000, … }, "availability": { "available": true } } ] }, … ]}{ "products": [ { "title": "Matilda Chair", "description": { "plain": "Solid…" }, "rating": { "value": 4.7, … }, "price_range": { "min": { "amount": 20000, … }, … }, "variants": [ … ] }, … ]}
获取特定产品的描述、选项、图片和评分,以及在每个销售该产品的商店中的对应价格。
$ shop catalog get '<product-id>' --select 'Color=Natural oak' \ --country US --currency USD$ shop catalog get '<product-id>' \ --select 'Color=Natural oak' \ --country US --currency USD
{ "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": 20000, … }, "availability": { "available": true } }, { "seller": { "name": "Kiln & Co." }, "price": { "amount": 21500, … }, "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 US --currency USD$ shop catalog lookup '<link>' \ '<link>' --ships-to US \ --currency USD
{ "products": [ { "title": "Matilda Chair", "price_range": { "min": { "amount": 20000, "currency": "USD" }, "max": { … } }, "variants": [ { "seller": { "name": "VNTI" }, "price": { "amount": 20000, … }, "availability": { "available": true } }, { "seller": { "name": "Kiln & Co." }, "price": { "amount": 21500, … }, "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 亿件产品。在 beta 版中,产品目录还包含了未在 Shopify 销售的品牌产品。此类产品默认处于关闭状态,仅面向美国购物者展示,并链接至品牌网站进行购买。在此详细了解 (在新标签页中打开)。
Shopify 商家的产品显示其商店的当前价格和库存。不在 Shopify 上销售的品牌,其产品信息则读取自他们自己的网站,因此价格和供货情况可能与原网站有所不同。
不可以。请勿缓存结果或重新托管商家图片。如有需要,请请求最新数据,并通过响应中的 URL 显示图片。进行测试时,请使用模拟数据。