Buscar productos

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" }
    ]
  }'

POST

ecommerce

apps

{app_id}

products

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" }
    ]
  }'

A diferencia de listar, este endpoint sí aplica filtros, búsqueda, scopes y ordenamiento, enviados en el cuerpo de la solicitud.

string

requerido

ID de tu tienda en Jelou Shop.

integer

predeterminado:"1"

Número de página a retornar.

integer

predeterminado:"15"

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

boolean

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

object

Objeto de búsqueda por texto.

Mostrar Propiedades de búsqueda

string

requerido

Texto a buscar en los campos name y sku.

boolean

predeterminado:"false"

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

object[]

Lista de filtros a aplicar.

Mostrar Propiedades de cada filtro

string

requerido

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

string

predeterminado:"="

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

string | number | boolean | array

requerido

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

object[]

Lista de scopes (filtros predefinidos) a aplicar.

Mostrar Propiedades de cada scope

string

requerido

Nombre del scope. Disponibles:

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

array

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

object[]

Ordenamiento de resultados.

Mostrar Propiedades de cada sort

string

requerido

Campo por el que ordenar. Disponible: created_at.

string

predeterminado:"asc"

Dirección del orden: asc o desc.

object[]

Lista de relaciones a expandir en la respuesta.

Mostrar Propiedades de cada include

string

requerido

Nombre de la relación. Disponibles: media, categories, attributes, prices, variations, variations.media, variations.productAttributes, attributeTypes, featureValues.

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" }
    ]
  }'

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

Para exportar los resultados a XLSX agrega ?download a la URL. La respuesta será el archivo en lugar de JSON.

⌘I

Empezando

Desarrollador

Jelou CLI

Mensajería Outbound

Gestión

Marketplace

Canales

Configuración

Facturación