List or query catalog items
GET {{baseUrl}}/catalog/{itemId}?merchantId=75a47707-7508-46b7-9195-01b3a61447a8&keywords=whey dux chocolate&bounds=-51.0,-30.0,-47.0,-21.0&ids=4ee30c20-f8e6-4516-ba46-98c930deaa78,b008e4ee-ecb2-47fc-b61c-6589a6493614&price=0.00-100.99&sort=score-,price+&start=0&limit=25
This endpoint is intended for search, and returns a streamlined version of each catalog item, containing only a single variant (the main variant).
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
merchantId | string | ||
keywords | string | ||
bounds | string | ||
ids | string | ||
price | string | ||
sort | string | ||
start | number | ||
limit | number |
RESPONSES
status: OK
{"start":0,"limit":25,"total":1256,"previous":null,"next":"","facets":[{"key":"Sabor","values":[{"key":"Chocolate","quantity":"10"},{"key":"Morango","quantity":"8"}]},{"key":"Faixa de preço","values":[{"key":"0 - 100","quantity":2},{"key":"101 - 300","quantity":18},{"key":"301 - 500","quantity":3}]}],"items":[{"id":"fb1ef5f9-863f-406a-ab7b-4150a636db1f","externalId":"507b78f4","url":"https://www.marketplace.com/products/fb1ef5f9/whey-protein-concentrado-pote-900g","merchant":{"id":"75a47707-7508-46b7-9195-01b3a61447a8","name":"DUX Nutrition Lab","url":"https://www.marketplace.com/merchants/75a47707/dux-nutrition-labs"},"title":"WHEY PROTEIN CONCENTRADO - POTE 900G","summary":"Proteína 100% pura, ideal para musculação e esportes de performance","coverUrl":"https://mywebsite.com.br/media/catalog/product/whey-900-sabores.jpg","brand":"DUX Nutrition Lab","category":{"id":"40d05a78-04b1-4e56-8a4b-b7c3ec999e53","name":"Sua \u003e Árvore \u003e De \u003e Categorias"},"keywords":"whey protein proteína 100% isolada bcaa dux","entryState":"draft|pendingApproval|published|closed","mainVariant":{"id":"9f817a0c-fcbf-483f-bfa5-94cf707875f4","externalId":"507b78f4","url":"https://www.marketplace.com/products/fb1ef5f9/9f817a0c/whey-protein-concentrado-pote-900g-chocolate","merchant":{"id":"75a47707-7508-46b7-9195-01b3a61447a8","name":"DUX Nutrition Lab","url":"https://www.marketplace.com/merchants/75a47707/dux-nutrition-labs"},"sku":"WHEYCONCPOTE900CHOC","gtin":"3234567890126","mpn":"H2G2-42","ncm":"string","condition":"notApplicable|new|refurbished|used","images":["https://mywebsite.com.br/media/catalog/product/whey-900-sabor-chocolate.jpg","https://mywebsite.com.br/media/catalog/product/whey-900-sabor-chocolate-verso.jpg"],"keywords":"chocolate (agrega automaticamente às keywords do produto)","entryState":"draft|pendingApproval|published|closed","price":"159.90 BRL","salePrice":"149.90 BRL","salePriceEffectiveDate":{"start":"2021-02-24T13:00-0300","end":"2021-02-29T15:30-0300"},"stock":999,"availability":"inStock|availableForOrder|onDemand|outOfStock","availabilityDate":{"start":"2021-02-24T13:00-0300","end":"2021-02-29T15:30-0300"},"attributes":[{"key":"Sabor","value":"Chocolate"}],"measurements":{"height":"30.0 cm","length":"15.0 cm","width":"15.0 cm","weight":"900 g"},"location":{"lat":-25.480877,"lng":-49.304424},"customData":[{"key":"Campo customizado","value":"Valor do campo customizado","visibility":"public|protected|private"},{"key":"googleCategory","value":"Health \u0026 Beauty \u003e Health Care \u003e Fitness \u0026 Nutrition \u003e Vitamins \u0026 Supplements","visibility":"public"}]},"customData":[{"key":"Campo customizado","value":"Valor do campo customizado","visibility":"public|protected|private"}]}]}