> ## 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.

# Buscar productos

> Filtra, busca y ordena productos, y opcionalmente expórtalos a XLSX.

A diferencia de [listar](https://docs.jelou.ai/api/shop/productos/listar.md), este endpoint sí aplica filtros, búsqueda, scopes y ordenamiento, enviados en el cuerpo de la solicitud.

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

ID de tu tienda en Jelou Shop.

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

Número de página a retornar.

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

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

**download** `boolean`

Si está presente, la respuesta es un archivo **XLSX** con los productos que cumplen los filtros, en lugar de JSON.

**search** `object`

Objeto de búsqueda por texto.

**Propiedades de búsqueda**

**value** `string` *required*

Texto a buscar en los campos `name` y `sku`.

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

Define si la búsqueda distingue entre mayúsculas y minúsculas.

**filters** `object[]`

Lista de filtros a aplicar.

**Propiedades de cada filtro**

**field** `string` *required*

Campo por el que filtrar: `created_at`, `price`, `has_tax` o `categories.id`.

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

Operador de comparación. Valores soportados: `=`, `!=`, `<`, `<=`, `>`, `>=`, `like`, `not like`, `in`, `not in`.

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

Valor del filtro. Usa un arreglo con los operadores `in` y `not in`.

**scopes** `object[]`

Lista de scopes (filtros predefinidos) a aplicar.

**Propiedades de cada scope**

**name** `string` *required*

Nombre del scope. Disponibles:

* `withDiscount` — solo productos con descuento.
* `withoutDiscount` — solo productos sin descuento.
* `whereDate` — productos creados entre dos fechas. Requiere `parameters: [desde, hasta]`.

**parameters** `array`

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

**sort** `object[]`

Ordenamiento de resultados.

**Propiedades de cada sort**

**field** `string` *required*

Campo por el que ordenar. Disponible: `created_at`.

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

Dirección del orden: `asc` o `desc`.

**includes** `object[]`

Lista de relaciones a expandir en la respuesta.

**Propiedades de cada include**

**relation** `string` *required*

Nombre de la relación. Disponibles: `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: TU_CLAVE_API" \
  -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 buscables:** `name`, `sku`
> **Campos filtrables:** `created_at`, `price`, `has_tax`, `categories.id`
> **Campos ordenables:** `created_at`
> **Scopes:** `withDiscount`, `withoutDiscount`, `whereDate`
> **Relaciones disponibles:** `media`, `categories`, `attributes`, `prices`, `variations`, `variations.media`, `variations.productAttributes`, `attributeTypes`, `featureValues`

> [!NOTE]
>
> Para exportar los resultados a XLSX agrega `?download` a la URL. La respuesta será el archivo en lugar de JSON.


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