Sign in

v1

latestSwagger 2.0BeezUP2026-07-13254876845.8 KB
Analytics - Statistics

Get the report by category

Get the report by category

post/v2/user/analytics/{storeId}/reports/bycategory

Path parameters

storeIdstring guid required

Your store identifier

Request body

channelIdstring guid

The channel identifier

periodType'Custom' | 'Yesterday' | 'Last7Days' | 'LastWeek' | 'ThisMonth' | 'Last30Days' | 'LastMonth' | 'Last60Days' | 'Last90Days' | 'Last3Months' required

Indicates the period type we want use for the report filter

beginPeriodUtcDatestring date-time

The begin date period you want to get the report. It's required only in case of custom period type !

endPeriodUtcDatestring date-time

The end date period you want to get the report. It's required only in case of custom period type !

orderBy'ClickCount' | 'Cost' | 'OrderCount' | 'ProductCount' | 'SoldProductCount' | 'DisabledProductCount' | 'EnabledProductCount' | 'TotalSales' | 'Margin' | 'ROI' | 'PerformanceIndicator'

Indicate on which indicator or value you want to make your formula

orderByDirection'Ascending' | 'Descending'

Indicate which direction to order results by

pageSizeinteger

Indicate the item count per page

pageNumberinteger

Indicates the page number

Example request

{
  "channelId": "2dc136a7-0d3d-4cc9-a825-a28a42c53e28",
  "beginPeriodUtcDate": "2006-11-20T00:00:00Z",
  "endPeriodUtcDate": "2006-12-20T00:00:00Z",
  "categoryFilter": {
    "categoryPath": [
      "Maison",
      "Chambre"
    ]
  },
  "performanceIndicatorFilters": [
    {
      "indicator": "Cost",
      "operatorName": "Equals",
      "value": "10"
    }
  ],
  "advancedFilters": {
    "marginType": "Global",
    "linkClickToOrderType": "OnClickDate",
    "performanceIndicatorFormula": {
      "firstParameter": "Cost",
      "operatorName": "Multiply",
      "secondParamter": "ROI",
      "thirdParameter": "100"
    }
  },
  "orderBy": "Cost",
  "orderByDirection": "Ascending"
}

Response

Your reporting by channel

currencyCodestring

The currency code <a href="https://en.wikipedia.org/wiki/ISO_4217">(ISO 4217)</a>

Example response

{
  "paginationResult": {
    "entryCount": "25",
    "pageCount": "38",
    "totalEntryCount": "943",
    "links": {
      "first": {
        "href": "/v2/user/marketplaces/orders/list/full",
        "method": "POST",
        "parameters": [
          {
            "name": "request",
            "in": "body",
            "type": "object",
            "schema": "orderListRequest",
            "value": {
              "beginPeriodUtcDate": "2014-08-25T07:32:31.584Z",
              "endPeriodUtcDate": "2014-09-24T07:32:31.584Z",
              "pageSize": "25",
              "pageNumber": "1"
            }
          }
        ]
      },
      "last": {
        "href": "/v2/user/marketplaces/orders/list/full",
        "method": "POST",
        "parameters": [
          {
            "name": "request",
            "in": "body",
            "type": "object",
            "schema": "orderListRequest",
            "value": {
              "beginPeriodUtcDate": "2014-08-25T07:32:31.584Z",
              "endPeriodUtcDate": "2014-09-24T07:32:31.584Z",
              "pageSize": "25",
              "pageNumber": "38"
            }
          }
        ]
      },
      "next": {
        "href": "/v2/user/marketplaces/orders/list/full",
        "method": "POST",
        "parameters": [
          {
            "name": "request",
            "in": "body",
            "type": "object",
            "schema": "orderListRequest",
            "value": {
              "beginPeriodUtcDate": "2014-08-25T07:32:31.584Z",
              "endPeriodUtcDate": "2014-09-24T07:32:31.584Z",
              "pageSize": "25",
              "pageNumber": "2"
            }
          }
        ]
      }
    }
  },
  "currencyCode": "EUR",
  "categories": [
    {
      "catalogCategoryId": "81a058a6-0451-4b79-84ef-94c58d0ed4ac",
      "catalogCategoryPath": [
        "Vêtements",
        "Femmes",
        "Chaussures"
      ],
      "links": {
        "enableProducts": {
          "href": "/v2/user/analytics/8f95eb1a-3691-4750-950d-a13c4a8a9bcc/optimisations/byCategory/4c376178-25b4-4656-a86e-e3bd3a25b139/enable",
          "method": "POST",
          "parameters": {
            "request": {
              "in": "body",
              "type": "​array",
              "value": [
                "a2d38563-50f0-43f1-be2b-b16e7ec4f007"
              ]
            }
          }
        },
        "disableProducts": {
          "href": "/v2/user/analytics/8f95eb1a-3691-4750-950d-a13c4a8a9bcc/optimisations/byCategory/4c376178-25b4-4656-a86e-e3bd3a25b139/enable",
          "method": "POST",
          "parameters": {
            "request": {
              "in": "body",
              "type": "​array",
              "value": [
                "a2d38563-50f0-43f1-be2b-b16e7ec4f007"
              ]
            }
          }
        }
      }
    }
  ],
  "links": {
    "enableAllProducts": {
      "href": "/v2/user/analytics/8f95eb1a-3691-4750-950d-a13c4a8a9bcc/optimisations/all/enable",
      "method": "POST",
      "parameters": {
        "request": {
          "in": "body",
          "type": "object",
          "schema": "optimiseAllRequest",
          "value": {
            "channelId": "2dc136a7-0d3d-4cc9-a825-a28a42c53e28",
            "beginPeriodUtcDate": "2006-11-20T00:00:00Z",
            "endPeriodUtcDate": "2006-12-20T00:00:00Z",
            "categoryFilter": {
              "categoryPath": [
                "Home",
                "Bedroom"
              ]
            },
            "performanceIndicatorFilters": [
              {
                "performanceIndicator": "Cost",
                "operatorName": "Equals",
                "value": "10"
              }
            ],
            "advancedFilters": {
              "marginType": "Global",
              "globalmarginPercent": "10",
              "linkClickToOrderType": "OnClickDate",
              "linkClickToOrderMaxDay": "5",
              "onlyPaymentValidatedOrders": "true",
              "onlyDirectSales": "true",
              "performanceIndicatorFormula": {
                "firstParameter": "Cost",
                "operatorName": "Multiply",
                "secondParamter": "ROI",
                "thirdParameter": "100"
              }
            },
            "productState": "All",
            "analyticsProductColumnFilters": {
              "sku": "M1234",
              "title": "Refrigérateur",
              "additionalAnalyticsProductColumnFilters": [
                {
                  "columnId": "672644c7-5bd0-4e25-88c1-1f732bda5e4c",
                  "operatorName": "NumericalGreaterThan",
                  "values": [
                    "100"
                  ]
                }
              ]
            }
          }
        }
      }
    },
    "disableAllProducts": {
      "href": "/v2/user/analytics/8f95eb1a-3691-4750-950d-a13c4a8a9bcc/optimisations/all/enable",
      "method": "POST",
      "parameters": {
        "request": {
          "in": "body",
          "type": "object",
          "schema": "optimiseAllRequest",
          "value": {
            "channelId": "2dc136a7-0d3d-4cc9-a825-a28a42c53e28",
            "beginPeriodUtcDate": "2006-11-20T00:00:00Z",
            "endPeriodUtcDate": "2006-12-20T00:00:00Z",
            "categoryFilter": {
              "categoryPath": [
                "Home",
                "Bedroom"
              ]
            },
            "performanceIndicatorFilters": [
              {
                "performanceIndicator": "Cost",
                "operatorName": "Equals",
                "value": "10"
              }
            ],
            "advancedFilters": {
              "marginType": "Global",
              "globalmarginPercent": "10",
              "linkClickToOrderType": "OnClickDate",
              "linkClickToOrderMaxDay": "5",
              "onlyPaymentValidatedOrders": "true",
              "onlyDirectSales": "true",
              "performanceIndicatorFormula": {
                "firstParameter": "Cost",
                "operatorName": "Multiply",
                "secondParamter": "ROI",
                "thirdParameter": "100"
              }
            },
            "productState": "All",
            "analyticsProductColumnFilters": {
              "sku": "M1234",
              "title": "Refrigérateur",
              "additionalAnalyticsProductColumnFilters": [
                {
                  "columnId": "672644c7-5bd0-4e25-88c1-1f732bda5e4c",
                  "operatorName": "NumericalGreaterThan",
                  "values": [
                    "100"
                  ]
                }
              ]
            }
          }
        }
      }
    },
    "enableProducts": {
      "href": "/v2/user/analytics/8f95eb1a-3691-4750-950d-a13c4a8a9bcc/optimisations/enable",
      "method": "POST",
      "parameters": {
        "request": {
          "in": "body",
          "type": "object",
          "schema": "optimiseRequest",
          "value": {
            "channelId": "2dc136a7-0d3d-4cc9-a825-a28a42c53e28",
            "beginPeriodUtcDate": "2006-11-20T00:00:00Z",
            "endPeriodUtcDate": "2006-12-20T00:00:00Z",
            "categoryFilter": {
              "categoryPath": [
                "Home",
                "Bedroom"
              ]
            },
            "performanceIndicatorFilters": [
              {
                "performanceIndicator": "Cost",
                "operatorName": "Equals",
                "value": "10"
              }
            ],
            "advancedFilters": {
              "marginType": "Global",
              "globalmarginPercent": "10",
              "linkClickToOrderType": "OnClickDate",
              "linkClickToOrderMaxDay": "5",
              "onlyPaymentValidatedOrders": "true",
              "onlyDirectSales": "true",
              "performanceIndicatorFormula": {
                "firstParameter": "Cost",
                "operatorName": "Multiply",
                "secondParamter": "ROI",
                "thirdParameter": "100"
              }
            },
            "pageSize": "100",
            "pageNumber": "1",
            "productState": "All",
            "analyticsProductColumnFilters": {
              "sku": "M1234",
              "title": "Refrigérateur",
              "additionalAnalyticsProductColumnFilters": [
                {
                  "columnId": "672644c7-5bd0-4e25-88c1-1f732bda5e4c",
                  "operatorName": "NumericalGreaterThan",
                  "values": [
                    "100"
                  ]
                }
              ]
            }
          }
        }
      }
    },
    "disableProducts": {
      "href": "/v2/user/analytics/8f95eb1a-3691-4750-950d-a13c4a8a9bcc/optimisations/enable",
      "method": "POST",
      "parameters": {
        "request": {
          "in": "body",
          "type": "object",
          "schema": "optimiseRequest",
          "value": {
            "channelId": "2dc136a7-0d3d-4cc9-a825-a28a42c53e28",
            "beginPeriodUtcDate": "2006-11-20T00:00:00Z",
            "endPeriodUtcDate": "2006-12-20T00:00:00Z",
            "categoryFilter": {
              "categoryPath": [
                "Home",
                "Bedroom"
              ]
            },
            "performanceIndicatorFilters": [
              {
                "performanceIndicator": "Cost",
                "operatorName": "Equals",
                "value": "10"
              }
            ],
            "advancedFilters": {
              "marginType": "Global",
              "globalmarginPercent": "10",
              "linkClickToOrderType": "OnClickDate",
              "linkClickToOrderMaxDay": "5",
              "onlyPaymentValidatedOrders": "true",
              "onlyDirectSales": "true",
              "performanceIndicatorFormula": {
                "firstParameter": "Cost",
                "operatorName": "Multiply",
                "secondParamter": "ROI",
                "thirdParameter": "100"
              }
            },
            "pageSize": "100",
            "pageNumber": "1",
            "productState": "All",
            "analyticsProductColumnFilters": {
              "sku": "M1234",
              "title": "Refrigérateur",
              "additionalAnalyticsProductColumnFilters": [
                {
                  "columnId": "672644c7-5bd0-4e25-88c1-1f732bda5e4c",
                  "operatorName": "NumericalGreaterThan",
                  "values": [
                    "100"
                  ]
                }
              ]
            }
          }
        }
      }
    }
  }
}