Ao contrário de listar, este endpoint aplica filtros, pesquisa, scopes e ordenação, enviados no corpo da solicitação.
O ID da sua loja no Jelou Shop.
Número da página a retornar.
Quantidade de resultados por página (máx. 200).
Se presente, a resposta é um arquivo XLSX com os produtos que atendem aos filtros, em vez de JSON.
Objeto de pesquisa por texto.Mostrar Propriedades de pesquisa
Texto a pesquisar nos campos name e sku.
Define se a pesquisa diferencia maiúsculas de minúsculas.
Lista de filtros a aplicar.Mostrar Propriedades de cada filtro
Campo pelo qual filtrar: created_at, price, has_tax ou categories.id.
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.
Lista de scopes (filtros predefinidos) a aplicar.Mostrar Propriedades de cada scope
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é].
Parâmetros do scope. Para whereDate: ["2026-01-01", "2026-01-31"].
Ordenação dos resultados.Mostrar Propriedades de cada sort
Campo pelo qual ordenar. Disponível: created_at.
Direção da ordenação: asc ou desc.
Lista de relações a expandir na resposta.Mostrar Propriedades de cada include
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.
