
gid://shopify/p/exampleCadeira · Carvalho naturalEncontre produtos por palavra-chave, imagem ou ambos. Filtre por preço, avaliação, cor, gênero, frete e muito mais.
$ 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": [ … ] }, … ]}
Obtenha a descrição, as opções, as imagens e as avaliações de um produto, além do preço em cada loja que o vende.
$ 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." } } ] }}
Use até 50 IDs de produtos ou links de lojas na Shopify para consultar preços atuais, estoque, imagens e um link de checkout.
$ 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/exampleCadeira · Carvalho natural







Não, mas eles trabalham em conjunto. O catálogo é o índice de pesquisa de produtos, e a pesquisa no shop.dev é executada nele. O shop.dev adiciona o login no Shop, o checkout com o Shop Pay e o rastreamento de pedidos. Comece por aqui se precisar apenas de pesquisa ou no shop.dev se o seu agente também processar o checkout.
Para testar, não. A pesquisa funciona sem chave com os limites de taxa mais baixos. Uma chave da Catalog API gerada no Dev Dashboard aumenta esses limites, e você precisará de uma em ambiente de produção.
Mais de 1 bilhão de produtos de milhões de lojistas na Shopify. Na versão beta, o catálogo também inclui produtos de marcas que não vendem na Shopify. Por padrão, esses produtos ficam desativados, aparecem apenas para compradores nos Estados Unidos e direcionam ao site da marca para a compra. Saiba mais aqui (abre em uma nova aba).
Os produtos de lojistas da Shopify apresentam os preços e o estoque atualizados da loja. Os produtos de marcas que não vendem na Shopify são lidos em seus sites; por isso, o preço e a disponibilidade podem diferir do site de origem.
Não. Não armazene resultados em cache nem re-hospede as imagens do lojista. Solicite dados atualizados quando precisar e mostre as imagens a partir das URLs na resposta. Para testes, use dados fictícios.