Listar produtos

curl "https://gateway.jelou.ai/ecommerce/v2/apps/{app_id}/products?limit=15" \
  -H "x-api-key: YOUR_API_KEY"

{
  "data": [
    {
      "id": "8af29efb-9864-4f29-888c-b2dd0d7ac1dd",
      "sku": "MM-0002",
      "name": "Kit de 3 Livros de Pano",
      "description": "Conjunto de 3 livros macios de pano ideais para bebês.",
      "price": 50,
      "price_without_tax": 50,
      "tax": "0.00",
      "has_tax": true,
      "discount_type": null,
      "discount": null,
      "status": true,
      "type": "physical_product",
      "stock_type": "limited",
      "stock_value": 0,
      "branch_id": null,
      "modifier_groups": [],
      "media": [
        {
          "id": 120,
          "collection_name": "images",
          "file_name": "cloth-book-set.jpg",
          "mime_type": "image/jpeg",
          "size": 84213,
          "custom_properties": { "source_url": "https://minha-loja.com/img/cloth-book-set.jpg" },
          "order_column": 1,
          "original_url": "https://cdn.jelou.ai/.../cloth-book-set.jpg",
          "created_at": "2026-02-27T02:24:33.000000Z",
          "updated_at": "2026-02-27T02:24:33.000000Z"
        }
      ],
      "stock_mutations": [
        {
          "id": 1,
          "stockable_type": "App\\Models\\Product",
          "stockable_id": "8af29efb-9864-4f29-888c-b2dd0d7ac1dd",
          "reference_type": null,
          "reference_id": null,
          "amount": 50,
          "description": null,
          "temporal": false,
          "created_at": "2026-02-27T02:24:33.000000Z",
          "updated_at": "2026-02-27T02:24:33.000000Z"
        }
      ],
      "created_at": "2026-02-27T02:24:33.000000Z",
      "updated_at": "2026-02-27T02:34:44.000000Z"
    },
    {
      "id": "c09b6094-5b0a-4c6a-b24c-4f4c42e83295",
      "sku": "MM-0003",
      "name": "Tapete de Atividades 3 em 1 - Pet's Party",
      "description": "Tapete de atividades 3 em 1 com tema de festa de animais.",
      "price": 5,
      "price_without_tax": 5,
      "tax": "0.00",
      "has_tax": true,
      "discount_type": "percentage",
      "discount": "20.00",
      "status": true,
      "type": "physical_product",
      "stock_type": "limited",
      "stock_value": 0,
      "branch_id": null,
      "modifier_groups": [],
      "media": [],
      "stock_mutations": [],
      "created_at": "2026-02-27T02:24:33.000000Z",
      "updated_at": "2026-02-27T02:34:45.000000Z"
    }
  ],
  "links": {
    "first": "https://gateway.jelou.ai/ecommerce/v2/apps/{app_id}/products?page=1",
    "last": "https://gateway.jelou.ai/ecommerce/v2/apps/{app_id}/products?page=19",
    "prev": null,
    "next": "https://gateway.jelou.ai/ecommerce/v2/apps/{app_id}/products?page=2"
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 19,
    "per_page": 15,
    "to": 15,
    "total": 276
  }
}

GET

ecommerce

apps

{app_id}

products

curl "https://gateway.jelou.ai/ecommerce/v2/apps/{app_id}/products?limit=15" \
  -H "x-api-key: YOUR_API_KEY"

{
  "data": [
    {
      "id": "8af29efb-9864-4f29-888c-b2dd0d7ac1dd",
      "sku": "MM-0002",
      "name": "Kit de 3 Livros de Pano",
      "description": "Conjunto de 3 livros macios de pano ideais para bebês.",
      "price": 50,
      "price_without_tax": 50,
      "tax": "0.00",
      "has_tax": true,
      "discount_type": null,
      "discount": null,
      "status": true,
      "type": "physical_product",
      "stock_type": "limited",
      "stock_value": 0,
      "branch_id": null,
      "modifier_groups": [],
      "media": [
        {
          "id": 120,
          "collection_name": "images",
          "file_name": "cloth-book-set.jpg",
          "mime_type": "image/jpeg",
          "size": 84213,
          "custom_properties": { "source_url": "https://minha-loja.com/img/cloth-book-set.jpg" },
          "order_column": 1,
          "original_url": "https://cdn.jelou.ai/.../cloth-book-set.jpg",
          "created_at": "2026-02-27T02:24:33.000000Z",
          "updated_at": "2026-02-27T02:24:33.000000Z"
        }
      ],
      "stock_mutations": [
        {
          "id": 1,
          "stockable_type": "App\\Models\\Product",
          "stockable_id": "8af29efb-9864-4f29-888c-b2dd0d7ac1dd",
          "reference_type": null,
          "reference_id": null,
          "amount": 50,
          "description": null,
          "temporal": false,
          "created_at": "2026-02-27T02:24:33.000000Z",
          "updated_at": "2026-02-27T02:24:33.000000Z"
        }
      ],
      "created_at": "2026-02-27T02:24:33.000000Z",
      "updated_at": "2026-02-27T02:34:44.000000Z"
    },
    {
      "id": "c09b6094-5b0a-4c6a-b24c-4f4c42e83295",
      "sku": "MM-0003",
      "name": "Tapete de Atividades 3 em 1 - Pet's Party",
      "description": "Tapete de atividades 3 em 1 com tema de festa de animais.",
      "price": 5,
      "price_without_tax": 5,
      "tax": "0.00",
      "has_tax": true,
      "discount_type": "percentage",
      "discount": "20.00",
      "status": true,
      "type": "physical_product",
      "stock_type": "limited",
      "stock_value": 0,
      "branch_id": null,
      "modifier_groups": [],
      "media": [],
      "stock_mutations": [],
      "created_at": "2026-02-27T02:24:33.000000Z",
      "updated_at": "2026-02-27T02:34:45.000000Z"
    }
  ],
  "links": {
    "first": "https://gateway.jelou.ai/ecommerce/v2/apps/{app_id}/products?page=1",
    "last": "https://gateway.jelou.ai/ecommerce/v2/apps/{app_id}/products?page=19",
    "prev": null,
    "next": "https://gateway.jelou.ai/ecommerce/v2/apps/{app_id}/products?page=2"
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 19,
    "per_page": 15,
    "to": 15,
    "total": 276
  }
}

string

obrigatório

O ID da sua loja no Jelou Shop.

integer

padrão:"15"

Número de produtos por página (máx. 200).

integer

padrão:"1"

Número da página a consultar.

string

Relações a incluir, separadas por vírgula. Disponíveis: media, categories, attributes, prices, variations, variations.media, variations.productAttributes, attributeTypes, featureValues.

Este endpoint não filtra, pesquisa nem ordena. Para aplicar filtros (price, has_tax, categories.id, created_at), pesquisar por name/sku, ordenar, usar scopes ou exportar para XLSX, use o endpoint Buscar produtos.

Campos da resposta

Cada produto em data contém os seguintes campos:

Campo	Tipo	Descrição
`id`	string	UUID do produto
`sku`	string	Identificador único do produto
`name`	string	Nome do produto
`description`	string	Descrição do produto
`price`	number	Preço do produto
`price_without_tax`	number	Preço sem impostos
`tax`	string	Valor do imposto
`has_tax`	boolean	Se o produto tem impostos
`discount_type`	string \| null	Tipo de desconto: `"value"` ou `"percentage"`
`discount`	string \| null	Valor do desconto
`status`	boolean	Se o produto está ativo
`type`	string	Tipo do produto (ex.: `"physical_product"`)
`stock_type`	string	Tipo de estoque: `"limited"` ou `"unlimited"`
`stock_value`	number	Quantidade de estoque disponível
`branch_id`	string \| null	UUID da filial atribuída
`modifier_groups`	array	Grupos de modificadores do produto
`media`	array	Imagens do produto (sempre incluídas)
`stock_mutations`	array	Movimentações de estoque (sempre incluídas)
`created_at`	string	Data de criação
`updated_at`	string	Data da última atualização

A resposta inclui paginação nos objetos links e meta:

Campo	Descrição
`meta.current_page`	Página atual
`meta.last_page`	Última página disponível
`meta.per_page`	Produtos por página
`meta.total`	Total de produtos
`links.next`	URL da próxima página
`links.prev`	URL da página anterior

curl "https://gateway.jelou.ai/ecommerce/v2/apps/{app_id}/products?limit=15" \
  -H "x-api-key: YOUR_API_KEY"

{
  "data": [
    {
      "id": "8af29efb-9864-4f29-888c-b2dd0d7ac1dd",
      "sku": "MM-0002",
      "name": "Kit de 3 Livros de Pano",
      "description": "Conjunto de 3 livros macios de pano ideais para bebês.",
      "price": 50,
      "price_without_tax": 50,
      "tax": "0.00",
      "has_tax": true,
      "discount_type": null,
      "discount": null,
      "status": true,
      "type": "physical_product",
      "stock_type": "limited",
      "stock_value": 0,
      "branch_id": null,
      "modifier_groups": [],
      "media": [
        {
          "id": 120,
          "collection_name": "images",
          "file_name": "cloth-book-set.jpg",
          "mime_type": "image/jpeg",
          "size": 84213,
          "custom_properties": { "source_url": "https://minha-loja.com/img/cloth-book-set.jpg" },
          "order_column": 1,
          "original_url": "https://cdn.jelou.ai/.../cloth-book-set.jpg",
          "created_at": "2026-02-27T02:24:33.000000Z",
          "updated_at": "2026-02-27T02:24:33.000000Z"
        }
      ],
      "stock_mutations": [
        {
          "id": 1,
          "stockable_type": "App\\Models\\Product",
          "stockable_id": "8af29efb-9864-4f29-888c-b2dd0d7ac1dd",
          "reference_type": null,
          "reference_id": null,
          "amount": 50,
          "description": null,
          "temporal": false,
          "created_at": "2026-02-27T02:24:33.000000Z",
          "updated_at": "2026-02-27T02:24:33.000000Z"
        }
      ],
      "created_at": "2026-02-27T02:24:33.000000Z",
      "updated_at": "2026-02-27T02:34:44.000000Z"
    },
    {
      "id": "c09b6094-5b0a-4c6a-b24c-4f4c42e83295",
      "sku": "MM-0003",
      "name": "Tapete de Atividades 3 em 1 - Pet's Party",
      "description": "Tapete de atividades 3 em 1 com tema de festa de animais.",
      "price": 5,
      "price_without_tax": 5,
      "tax": "0.00",
      "has_tax": true,
      "discount_type": "percentage",
      "discount": "20.00",
      "status": true,
      "type": "physical_product",
      "stock_type": "limited",
      "stock_value": 0,
      "branch_id": null,
      "modifier_groups": [],
      "media": [],
      "stock_mutations": [],
      "created_at": "2026-02-27T02:24:33.000000Z",
      "updated_at": "2026-02-27T02:34:45.000000Z"
    }
  ],
  "links": {
    "first": "https://gateway.jelou.ai/ecommerce/v2/apps/{app_id}/products?page=1",
    "last": "https://gateway.jelou.ai/ecommerce/v2/apps/{app_id}/products?page=19",
    "prev": null,
    "next": "https://gateway.jelou.ai/ecommerce/v2/apps/{app_id}/products?page=2"
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 19,
    "per_page": 15,
    "to": 15,
    "total": 276
  }
}

Substitua {app_id} pelo ID da sua loja e YOUR_API_KEY pela sua chave de API.

⌘I

Primeiros Passos

Desenvolvedor

Jelou CLI

Mensagens Outbound

Gestão

Marketplace

Canais

Configuração

Faturamento

Campos da resposta

​Campos da resposta

Campos da resposta