> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Pesquisar produtos

> Filtre, pesquise e ordene produtos e, opcionalmente, exporte-os para XLSX.

Ao contrário de [listar](https://docs.jelou.ai/pt/api/shop/produtos/listar.md), este endpoint aplica filtros, pesquisa, scopes e ordenação, enviados no corpo da solicitação.

**app\_id** `string` *required*

O ID da sua loja no Jelou Shop.

**page** `integer` (default: 1)

Número da página a retornar.

**limit** `integer` (default: 15)

Quantidade de resultados por página (máx. 200).

**download** `boolean`

Se presente, a resposta é um arquivo **XLSX** com os produtos que atendem aos filtros, em vez de JSON.

**search** `object`

Objeto de pesquisa por texto.

**Propriedades de pesquisa**

**value** `string` *required*

Texto a pesquisar nos campos `name` e `sku`.

**case\_sensitive** `boolean` (default: false)

Define se a pesquisa diferencia maiúsculas de minúsculas.

**filters** `object[]`

Lista de filtros a aplicar.

**Propriedades de cada filtro**

**field** `string` *required*

Campo pelo qual filtrar: `created_at`, `price`, `has_tax` ou `categories.id`.

**operator** `string` (default: =)

Operador de comparação. Valores suportados: `=`, `!=`, `<`, `<=`, `>`, `>=`, `like`, `not like`, `in`, `not in`.

**value** `string | number | boolean | array` *required*

Valor do filtro. Use um array com os operadores `in` e `not in`.

**scopes** `object[]`

Lista de scopes (filtros predefinidos) a aplicar.

**Propriedades de cada scope**

**name** `string` *required*

Nome do scope. Disponíveis:

* `withDiscount` — apenas produtos com desconto.
* `withoutDiscount` — apenas produtos sem desconto.
* `whereDate` — produtos criados entre duas datas. Requer `parameters: [de, até]`.

**parameters** `array`

Parâmetros do scope. Para `whereDate`: `["2026-01-01", "2026-01-31"]`.

**sort** `object[]`

Ordenação dos resultados.

**Propriedades de cada sort**

**field** `string` *required*

Campo pelo qual ordenar. Disponível: `created_at`.

**direction** `string` (default: asc)

Direção da ordenação: `asc` ou `desc`.

**includes** `object[]`

Lista de relações a expandir na resposta.

**Propriedades de cada include**

**relation** `string` *required*

Nome da relação. Disponíveis: `media`, `categories`, `attributes`, `prices`, `variations`, `variations.media`, `variations.productAttributes`, `attributeTypes`, `featureValues`.

```bash cURL theme={null}
curl -X POST "https://gateway.jelou.ai/ecommerce/v2/apps/{app_id}/products/search?page=1&limit=20" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "search": {
      "value": "camiseta",
      "case_sensitive": false
    },
    "filters": [
      { "field": "price", "operator": ">=", "value": 10 },
      { "field": "has_tax", "operator": "=", "value": true }
    ],
    "scopes": [
      { "name": "withDiscount" }
    ],
    "sort": [
      { "field": "created_at", "direction": "desc" }
    ],
    "includes": [
      { "relation": "variations" }
    ]
  }'
```

> [!TIP]
>
> **Campos pesquisáveis:** `name`, `sku`
> **Campos filtráveis:** `created_at`, `price`, `has_tax`, `categories.id`
> **Campos ordenáveis:** `created_at`
> **Scopes:** `withDiscount`, `withoutDiscount`, `whereDate`
> **Relações disponíveis:** `media`, `categories`, `attributes`, `prices`, `variations`, `variations.media`, `variations.productAttributes`, `attributeTypes`, `featureValues`

> [!NOTE]
>
> Para exportar os resultados para XLSX, adicione `?download` à URL. A resposta será o arquivo em vez de JSON.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.