查询类目列表 - Ozon 数据服务平台API

请求参数

Authorization

API Key

在 header 添加参数

Authorization

示例：

Authorization: ********************

or

Body 参数application/json必填

示例

{
    "pageNo": 1,
    "pageSize": 15,
    "language": "CH",
    "level1CategoryId": 12345,
    "categoryId": 67890,
    "period": "DAY",
    "updatePeriod": "2026-05-20",
    "minSales": 0,
    "maxSales": 0,
    "minSignedSalesRatio": 0,
    "maxSignedSalesRatio": 0,
    "minSalesCardsRatio": 0,
    "maxSalesCardsRatio": 0,
    "minBuyoutPercent": 0,
    "maxBuyoutPercent": 0,
    "sortField": "SALES",
    "sortDirection": "ASC"
}

请求示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location '/api/v1/categories/list/query' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "pageNo": 1,
    "pageSize": 15,
    "language": "CH",
    "level1CategoryId": 12345,
    "categoryId": 67890,
    "period": "DAY",
    "updatePeriod": "2026-05-20",
    "minSales": 0,
    "maxSales": 0,
    "minSignedSalesRatio": 0,
    "maxSignedSalesRatio": 0,
    "minSalesCardsRatio": 0,
    "maxSalesCardsRatio": 0,
    "minBuyoutPercent": 0,
    "maxBuyoutPercent": 0,
    "sortField": "SALES",
    "sortDirection": "ASC"
}'

返回响应

🟢200

application/json

OK

Bodyapplication/json

示例

{
    "success": true,
    "errorCode": "string",
    "errorMessage": "string",
    "data": [
        {
            "categoryId": 0,
            "level1CategoryId": 0,
            "level2CategoryId": 0,
            "categoryPathZh": "string",
            "categoryPathRu": "string",
            "updatePeriod": "2026-05-20",
            "sales": 0,
            "salesDynamics": "50.00%",
            "signedSales": 0,
            "signedSalesRatio": "50.00%",
            "gmv": 123.45,
            "gmvDynamics": "50.00%",
            "signedGmv": 123.45,
            "signedGmvRatio": "50.00%",
            "cards": 0,
            "salesCards": 0,
            "salesCardsDynamics": "50.00%",
            "salesCardsRatio": "50.00%",
            "suppliers": 0,
            "salesSuppliers": 0,
            "salesSuppliersDynamics": "50.00%",
            "salesSuppliersRatio": "50.00%",
            "avgPrice": 123.45,
            "signedCards": 0,
            "signedCardsDynamics": "50.00%",
            "signedCardsRatio": "50.00%",
            "signedSuppliers": 0,
            "signedSuppliersRatio": "50.00%",
            "salesBrand": 0,
            "signedBrand": 0,
            "signedBrandRatio": "50.00%",
            "avgStock": 0,
            "turnover": 123.45,
            "monopolization": 123.45,
            "availability": "string",
            "buyoutPercent": "50.00%",
            "categoryLevel": 0
        }
    ],
    "total": 100,
    "pageNo": 1,
    "pageSize": 20
}

🟠400

🟠401

🟠403

🔴500