---
title: "Listar Produtos retornados pela busca"
method: GET
path: "/{alias}/search/products"
tags: ["Busca - Produtos"]
---

# Listar Produtos retornados pela busca

`GET /{alias}/search/products`

## Request

- Base URL: `https://api.dooki.com.br/v2`
- URL: `https://api.dooki.com.br/v2/{alias}/search/products`
- Auth: API key in header `User-Token` and API key in header `User-Secret-Key`

lista produtos retornados pela busca

## Path parameters

- `alias` string, required

## Response `200`

Lista de produtos através motor de busca

- object
  - `data` object: Recursos adicionais do produto, retornados sob demanda via parâmetro `include`.
    - `id` integer: Identificador único do produto.
    - `merchant_id` integer: ID da loja
    - `affiliation_id` integer: ID de afiliação do produto
    - `erp_id` integer: ID do produto no ERP
    - `seller_id` integer: ID do vendedor
    - `active` boolean: Indica se o produto está ativo
    - `searchable` boolean: Indica se o produto é buscável
    - `is_digital` boolean: Indica se o produto é digital
    - `rating` integer: Nota média de avaliação do produto.
    - `priority` integer: Nível de relevância (1 -> Padrão, 2 -> Média, 3 -> Alta)
    - `ncm` string: Código NCM do produto
    - `name` string: Nome do produto
    - `slug` string: Slug (URL amigável) do produto
    - `warranty` integer: Garantia em meses
    - `custom_shipping` boolean: Indica se o Frete é customizado
    - `shipping_price` number, float: Valor do frete customizado em reais
    - `gift_value` number, float: Valor de presente (se aplicável)
    - `simple` boolean: Indica se o produto é simples
    - `days_availability_formated` string: Tempo de disponibilidade em dias
    - `variations` string[]: Lista de variações do produto
    - `combinations` string[]: Lista dos identificadores de combinação de variações de cada SKU do produto.
    - `total_in_stock` integer: Quantidade total disponível em estoque
    - `relevance` integer: Nível de prioridade do produto na busca (1 = padrão, 2 = média, 3 = alta), definido pelo campo `priority` na requisição.
    - `has_variations` boolean: Indica se o produto possui variações
    - `sku` string: Código identificador principal do produto
    - `url` string, url: URL pública do produto
    - `redirect_url_card` string, url, nullable: URL de redirecionamento após compra no cartão
    - `redirect_url_billet` string, url, nullable: URL de redirecionamento após compra no boleto
    - `total_orders` integer: Número total de pedidos realizados do produto
    - `image_reference_sku_id` integer: ID do SKU de referência de onde as imagens deste SKU são herdadas, quando configurado.
    - `purchase_url` string: URL direta para a compra do produto
    - `preview_url` string, url: URL de pré-visualização do produto
    - `created_at` BaseTimestamp: Data e hora no formato de objeto devolvido pelo PHP, com o fuso horário em que foi registrada.
      - `date` string: Data e hora no formato YYYY-MM-DD H:MM:SS.
      - `timezone_type` integer: Número de representação do timezone.
      - `timezone` string: Fuso horário associado.
    - `updated_at` BaseTimestamp: Data e hora no formato de objeto devolvido pelo PHP, com o fuso horário em que foi registrada.
      - `date` string: Data e hora no formato YYYY-MM-DD H:MM:SS.
      - `timezone_type` integer: Número de representação do timezone.
      - `timezone` string: Fuso horário associado.

## Other responses

- `400`: Requisição inválida
- `404`: URL inválida

## Changes

- **2026-11-03** `bbafb577e11c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/yampi/apis/yampi-api/changes/:alias/search/products/get.md)

---

[API](https://skmtc.dev/yampi/apis/yampi-api.md) - [All operations](https://skmtc.dev/yampi/apis/yampi-api/llms.txt) - [OpenAPI document](https://skmtc.dev/yampi/apis/yampi-api/revisions/74739ec8876f?raw)