Seznam produktů
Získá seznam produktů s možností filtrování, stránkování a řazení. Endpoint umožňuje zobrazit základní informace o produktech včetně jejich atributů, cenových statistik, informací o trzích a průměrných ukazatelů popularity. Podporuje pokročilé filtrování podle kategorií, značek, generalizovaných produktů a vlastních atributů.
API specifikace
Retrieves a paginated list of products with optional filtering, sorting, and ordering.
Request parameters
Responses
[
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"name": "Organic Whole Milk 1L",
"attributes": [
{
"type": "ProductAttributeStringValue",
"definitionId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"definitionName": "Origin",
"value": "Denmark"
},
{
"type": "ProductAttributeEnumValue",
"definitionId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"definitionName": "Fat Content",
"value": {
"optionId": "c3d4e5f6-a7b8-9012-cdef-123456789012",
"value": "3.5%"
}
}
],
"externalId": "EAN-5901234123457",
"productCount": 1,
"generalizedProduct": {
"id": "d4e5f6a7-b8c9-0123-def0-234567890123",
"name": "Milk"
},
"variant": {
"id": "e5f6a7b8-c9d0-1234-ef01-345678901234",
"name": "1L Carton"
},
"brand": {
"id": "f6a7b8c9-d0e1-2345-f012-456789012345",
"name": "Arla"
},
"minPrice": 1.49,
"maxPrice": 2.29,
"summary": {
"lifetime": 365.0,
"customers": 15420,
"totalQuantity": 48500.0,
"totalPrice": 87300.5,
"quantityPerCustomer": 3.15
},
"productInMarket": {
"a7b8c9d0-e1f2-3456-0123-567890123456": {
"market": {
"id": "a7b8c9d0-e1f2-3456-0123-567890123456",
"name": "Copenhagen Store"
},
"priceType": {
"id": "b8c9d0e1-f234-5670-1234-678901234567",
"name": "Regular"
},
"price": 1.99,
"validFrom": "2024-01-01T00:00:00Z",
"validTo": null,
"lastUpdated": "2024-06-15T10:30:00Z"
}
},
"avgPopularityStat": {
"granularity": 30,
"customerCount": 1250,
"basketCount": 1580,
"quantity": 2150.0,
"growthRate": 0.12,
"trend": "Increasing",
"lastUpdated": "2024-06-15T00:00:00Z"
}
}
]
15 January 2026