Search 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": "t-shirt",
      "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": "t-shirt",
      "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" }
    ]
  }'

Unlike list, this endpoint does apply filters, search, scopes and sorting, sent in the request body.

string

required

Your store ID in Jelou Shop.

integer

default:"1"

Page number to return.

integer

default:"15"

Number of results per page (max. 200).

boolean

If present, the response is an XLSX file with the products matching the filters, instead of JSON.

object

Text search object.

Show Search properties

string

required

Text to search in the name and sku fields.

boolean

default:"false"

Whether the search is case-sensitive.

object[]

List of filters to apply.

Show Properties of each filter

string

required

Field to filter by: created_at, price, has_tax or categories.id.

string

default:"="

Comparison operator. Supported values: =, !=, <, <=, >, >=, like, not like, in, not in.

string | number | boolean | array

required

Filter value. Use an array with the in and not in operators.

object[]

List of scopes (predefined filters) to apply.

Show Properties of each scope

string

required

Scope name. Available:

withDiscount — only products with a discount.
withoutDiscount — only products without a discount.
whereDate — products created between two dates. Requires parameters: [from, to].

array

Scope parameters. For whereDate: ["2026-01-01", "2026-01-31"].

object[]

Result ordering.

Show Properties of each sort

string

required

Field to sort by. Available: created_at.

string

default:"asc"

Sort direction: asc or desc.

object[]

List of relations to expand in the response.

Show Properties of each include

string

required

Relation name. Available: 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": "t-shirt",
      "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" }
    ]
  }'

Searchable fields: name, sku Filterable fields: created_at, price, has_tax, categories.id Sortable fields: created_at Scopes: withDiscount, withoutDiscount, whereDate Available relations: media, categories, attributes, prices, variations, variations.media, variations.productAttributes, attributeTypes, featureValues

To export the results to XLSX add ?download to the URL. The response will be the file instead of JSON.

⌘I

Getting Started

Developer

Jelou CLI

Outbound Messaging

Management

Marketplace

Channels

Configuration

Billing