Buscar produtos

Busca produtos ativos da loja por nome, descrição, SKU ou código de barras — incluindo correspondências nas variantes.

Autenticação: token Bearer com a ability storefront:read + header X-Store-Slug. Ver autenticação → Limite de 300 requisições/min — ver erros e limites.

Parâmetros de Query

Exemplo de Requisição

curl --location 'https://api.aproveicheckout.com.br/v1/search?q=camiseta' \
--header 'Authorization: Bearer SEU_TOKEN' \
--header 'X-Store-Slug: SLUG_DA_LOJA'

Resposta

Mesmo formato de Listar produtos (products no formato Objeto Produto + pagination), com o campo extra query ecoando o termo buscado. Quando o termo casa com uma variante específica, o produto pai é retornado apenas com as variantes que corresponderam à busca.

{
  "products": [ { "...": "mesmo formato de Listar produtos" } ],
  "pagination": { "page": 1, "per_page": 12, "total": 1, "total_pages": 1 },
  "query": "camiseta"
}