查询关键词趋势快照 - Ozon 数据服务平台API

请求参数

Authorization

API Key

在 header 添加参数

Authorization

示例：

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

or

Body 参数application/json必填

示例

{
    "pageNo": 1,
    "pageSize": "15",
    "keywordId": 123456789,
    "period": "WEEK",
    "startUpdatePeriod": "2026-04-27",
    "endUpdatePeriod": "2026-05-26",
    "sortDirection": "ASC"
}

请求示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location '/api/v1/keywords/trends/snapshots/query' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "pageNo": 1,
    "pageSize": "15",
    "keywordId": 123456789,
    "period": "WEEK",
    "startUpdatePeriod": "2026-04-27",
    "endUpdatePeriod": "2026-05-26",
    "sortDirection": "ASC"
}'

返回响应

🟢200

application/json

OK

Bodyapplication/json

示例

{
    "success": true,
    "errorCode": "string",
    "errorMessage": "string",
    "data": [
        {
            "keywordId": 0,
            "keyword": "string",
            "keywordCn": "string",
            "categoryId": 0,
            "categoryName": "string",
            "searchIndex": 0,
            "searchIndexGrowthRate": "50.00%",
            "conversionIndex": 123.45,
            "cartConversionRate": "50.00%",
            "exposureIndex": 123.45,
            "productCount": 0,
            "supplyDemandRatio": 123.45,
            "orderedProductCount": 0,
            "orderConversionRate": "50.00%",
            "orderedAmount": 123.45,
            "averageBrowseProductCount": 0,
            "cartAveragePrice": 123.45,
            "competitorCount": 0,
            "searchVolumeGrowthRate": "50.00%",
            "noActionQueryCount": 0,
            "noActionQueryShare": "50.00%",
            "similarResultQueryCount": 0,
            "similarResultQueryRatio": "50.00%",
            "noResultQueryCount": 0,
            "noResultQueryRatio": "50.00%",
            "updatePeriod": "string"
        }
    ],
    "total": 100,
    "pageNo": 1,
    "pageSize": 20
}

🟠400

🟠401

🟠403

🔴500