Buscar productos - Jelou AI Docs

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.

app_id

string

requerido

ID de tu tienda en Jelou Shop.

page

integer

predeterminado:"1"

Número de página a retornar.

limit

integer

predeterminado:"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.

object

Objeto de búsqueda por texto.

Mostrar Propiedades de búsqueda

value

string

requerido

Texto a buscar en los campos name y sku.

case_sensitive

boolean

predeterminado:"false"

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

filters

object[]

Lista de filtros a aplicar.

Mostrar Propiedades de cada filtro

field

string

requerido

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

operator

string

predeterminado:"="

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

value

string | number | boolean | array

requerido

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

scopes

object[]

Lista de scopes (filtros predefinidos) a aplicar.

Mostrar Propiedades de cada scope

name

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

parameters

array

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

sort

object[]

Ordenamiento de resultados.

Mostrar Propiedades de cada sort

field

string

requerido

Campo por el que ordenar. Disponible: created_at.

direction

string

predeterminado:"asc"

Dirección del orden: asc o desc.

includes

object[]

Lista de relaciones a expandir en la respuesta.

Mostrar Propiedades de cada include

relation

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.

Listar productos

Configuración de tienda

⌘I