Buscar produtos

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

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

Ao contrário de listar, este endpoint aplica filtros, pesquisa, scopes e ordenação, enviados no corpo da solicitação.

app_id

string

obrigatório

O ID da sua loja no Jelou Shop.

page

integer

padrão:"1"

Número da página a retornar.

limit

integer

padrão:"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.

object

Objeto de pesquisa por texto.

Mostrar Propriedades de pesquisa

value

string

obrigatório

Texto a pesquisar nos campos name e sku.

case_sensitive

boolean

padrão:"false"

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

filters

object[]

Lista de filtros a aplicar.

Mostrar Propriedades de cada filtro

field

string

obrigatório

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

operator

string

padrão:"="

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

value

string | number | boolean | array

obrigatório

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

scopes

object[]

Lista de scopes (filtros predefinidos) a aplicar.

Mostrar Propriedades de cada scope

name

string

obrigatório

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.

Mostrar Propriedades de cada sort

field

string

obrigatório

Campo pelo qual ordenar. Disponível: created_at.

direction

string

padrão:"asc"

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

includes

object[]

Lista de relações a expandir na resposta.

Mostrar Propriedades de cada include

relation

string

obrigatório

Nome da relação. Disponíveis: 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: 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" }
    ]
  }'

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

Para exportar os resultados para XLSX, adicione ?download à URL. A resposta será o arquivo em vez de JSON.

Listar produtos

Criar cupom

⌘I

Primeiros Passos

Agentes de IA

Nós

Variáveis

Observabilidade nos Workflows

Mensagens Outbound

Gestão

Marketplace

Canais

Configuração

Faturamento