Detail produktu

Získá detailní informace o konkrétním produktu včetně všech atributů, statistik popularity a demografických dat. Endpoint vrací kompletní informace o produktu: základní údaje (název, popis, jednotku, množství), vazby na značku, generalizovaný produkt a variantu, identifikátory (EAN, UPC, SKU a další), agregované statistiky podle časových granularit a demografických dimenzí.

API specifikace

/admin/product/{id}

Retrieves detailed information about a specific product including all statistics and attributes.

Request parameters

Responses

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Organic Whole Milk 1L",
  "description": "Fresh organic whole milk from grass-fed cows, pasteurized and homogenized.",
  "unit": "L",
  "unitAmount": 1.0,
  "externalId": "EAN-5901234123457",
  "summary": {
    "lifetime": 365.0,
    "customers": 15420,
    "totalQuantity": 48500.0,
    "totalPrice": 87300.5,
    "quantityPerCustomer": 3.15
  },
  "generalizedProduct": {
    "id": "d4e5f6a7-b8c9-0123-def0-234567890123",
    "name": "Milk"
  },
  "variant": {
    "id": "e5f6a7b8-c9d0-1234-ef01-345678901234",
    "name": "1L Carton"
  },
  "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%"
      }
    },
    {
      "type": "ProductAttributeBooleanValue",
      "definitionId": "d4e5f6a7-b8c9-0123-def0-234567890124",
      "definitionName": "Organic",
      "value": true
    },
    {
      "type": "ProductAttributeNumericValue",
      "definitionId": "e5f6a7b8-c9d0-1234-ef01-345678901235",
      "definitionName": "Calories per 100ml",
      "value": 64.5
    }
  ],
  "brand": {
    "id": "f6a7b8c9-d0e1-2345-f012-456789012345",
    "name": "Arla"
  },
  "lastUpdated": "2024-06-15T10:30:00Z",
  "created": "2023-01-15T08:00:00Z",
  "thumbnail": "https://cdn.thisandthat.ai/products/550e8400-e29b-41d4-a716-446655440000/thumb.jpg",
  "externalIdType": "EAN",
  "identifiers": [
    {
      "value": "5901234123457",
      "isPrimary": true,
      "type": "EAN",
      "lastUpdated": "2023-01-15T08:00:00Z"
    },
    {
      "value": "ARLA-MILK-1L-001",
      "isPrimary": false,
      "type": "SKU",
      "lastUpdated": "2023-01-15T08:00:00Z"
    }
  ],
  "avgPopularityStats": {
    "7": {
      "granularity": 7,
      "customerCount": 320,
      "basketCount": 410,
      "quantity": 550.0,
      "growthRate": 0.08,
      "trend": "Increasing",
      "lastUpdated": "2024-06-15T00:00:00Z"
    },
    "30": {
      "granularity": 30,
      "customerCount": 1250,
      "basketCount": 1580,
      "quantity": 2150.0,
      "growthRate": 0.12,
      "trend": "Increasing",
      "lastUpdated": "2024-06-15T00:00:00Z"
    },
    "90": {
      "granularity": 90,
      "customerCount": 3800,
      "basketCount": 4850,
      "quantity": 6500.0,
      "growthRate": 0.05,
      "trend": "Stable",
      "lastUpdated": "2024-06-15T00:00:00Z"
    }
  },
  "popularityStatsPerMarket": {
    "a7b8c9d0-e1f2-3456-0123-567890123456": {
      "30": {
        "marketId": "a7b8c9d0-e1f2-3456-0123-567890123456",
        "granularity": 30,
        "customerCount": 650,
        "basketCount": 820,
        "quantity": 1100.0,
        "growthRate": 0.15,
        "trend": "Increasing",
        "lastUpdated": "2024-06-15T00:00:00Z"
      }
    },
    "b8c9d0e1-f234-5670-1234-678901234568": {
      "30": {
        "marketId": "b8c9d0e1-f234-5670-1234-678901234568",
        "granularity": 30,
        "customerCount": 600,
        "basketCount": 760,
        "quantity": 1050.0,
        "growthRate": 0.09,
        "trend": "Stable",
        "lastUpdated": "2024-06-15T00:00:00Z"
      }
    }
  },
  "avgDemographicStats": {
    "Age": {
      "25-34": {
        "dimension": "Age",
        "dimensionValue": "25-34",
        "customerCount": 4500,
        "percentage": 35.2,
        "isExtreme": false,
        "isDominant": false,
        "lastUpdated": "2024-06-15T00:00:00Z"
      },
      "35-44": {
        "dimension": "Age",
        "dimensionValue": "35-44",
        "customerCount": 5200,
        "percentage": 40.6,
        "isExtreme": false,
        "isDominant": true,
        "lastUpdated": "2024-06-15T00:00:00Z"
      }
    },
    "Gender": {
      "Female": {
        "dimension": "Gender",
        "dimensionValue": "Female",
        "customerCount": 8500,
        "percentage": 66.4,
        "isExtreme": true,
        "isDominant": true,
        "lastUpdated": "2024-06-15T00:00:00Z"
      },
      "Male": {
        "dimension": "Gender",
        "dimensionValue": "Male",
        "customerCount": 4300,
        "percentage": 33.6,
        "isExtreme": false,
        "isDominant": false,
        "lastUpdated": "2024-06-15T00:00:00Z"
      }
    }
  },
  "demographicStatsPerMarket": {
    "a7b8c9d0-e1f2-3456-0123-567890123456": {
      "Gender": {
        "Female": {
          "marketId": "a7b8c9d0-e1f2-3456-0123-567890123456",
          "dimension": "Gender",
          "dimensionValue": "Female",
          "customerCount": 4200,
          "percentage": 68.5,
          "isExtreme": true,
          "isDominant": true,
          "lastUpdated": "2024-06-15T00:00:00Z"
        }
      }
    }
  }
}

15 January 2026