获取商品搜索查询信息

使用该方法可以获取您的商品在 Ozon 平台上的搜索查询信息。完整分析数据仅适用于Premium 和 Premium Plus订阅用户。未订阅的用户可以查看部分指标。该方法类似于个人中心的 搜索中的商品 → 我的商品的查询 选项卡。

可以按指定日期范围获取分析数据。为此，需在请求中指定 date_from 和 date_to 参数。最近 1 个月的数据可随时查询，但不包括距离当前日期 3 天内的数据（此时间段的数据仍在计算中）。超过 1 个月前的数据仅适用于 Premium 及 Premium Plus 订阅用户，并且只能按周查询，需在请求中指定 date_from 参数。

您可以在 Ozon for Dev 开发者社区的讨论区留下反馈。

请求参数

Header 参数

Client-Id

string

用户识别号。

必需

Api-Key

string

API-密钥。

必需

Body 参数application/json

date_from

string <date-time>

必需

分析数据的起始日期。

date_to

string <date-time>

可选

分析数据的结束日期。

page

integer <int32>

请求返回的页码。

可选

page_size

integer <int32>

必需

每页包含的商品数量。

skus

array[string <int64>]

必需

SKU 列表，即 Ozon 系统中的商品标识符。根据这些 SKU 返回搜索查询的分析数据。最多可查询 1000 个 SKU。

sort_by

enum<string>

可选

按具体参数对商品进行排序。可能的取值：

BY_SEARCHES— 按搜索次数；

BY_VIEWS— 按浏览量；

BY_POSITION— 按商品的平均排名；

BY_CONVERSION— 按转化率；

BY_GMV — 按搜索查询的销售额。

枚举值:

BY_SEARCHESBY_VIEWSBY_POSITIONBY_CONVERSIONBY_GMV

默认值:

BY_SEARCHES

sort_dir

enum<string>

可选

排序方向：

DESCENDING— 降序；

ASCENDING— 升序。

枚举值:

DESCENDINGASCENDING

默认值:

DESCENDING

示例

{
    "date_from": "2019-08-24T14:15:22Z",
    "date_to": "2019-08-24T14:15:22Z",
    "page": 0,
    "page_size": 0,
    "skus": [
        "string"
    ],
    "sort_by": "BY_SEARCHES",
    "sort_dir": "DESCENDING"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

商品搜索查询信息

Body

analytics_period

object (AnalyticsProductQueriesResponseAnalyticsPeriod)

可选

数据分析的时间范围。

date_from

string

可选

分析数据的起始日期。

date_to

string

可选

分析数据的结束日期。

items

array[object (v1AnalyticsProductQueriesResponseItem) {10}]

商品列表。

可选

category

string

类目名称。

可选

currency

string

货币单位。

可选

gmv

number <float>

搜索查询的销售额。

可选

name

string

商品名称。

可选

offer_id

string

可选

卖家系统中的商品标识符（商品编号）。

position

number <float>

可选

商品的平均排名。仅适用于Premium 或 Premium Plus 订阅，否则该字段为空。

sku

integer <int64>

可选

Ozon 系统中的商品标识符（SKU）。

unique_search_users

integer <int64>

可选

在 Ozon 平台上搜索该商品的买家数量。

unique_view_users

integer <int64>

可选

在 Ozon 平台上看到该商品的买家数量。仅适用于Premium 或 Premium Plus 订阅，否则该字段为空。

view_conversion

number <float>

可选

商品的转化率。仅适用于Premium 或 Premium Plus 订阅，否则该字段为空。

page_count

integer <int64>

总页数。

可选

total

integer <int64>

搜索请求的总数。

可选

示例

{
    "analytics_period": {
        "date_from": "string",
        "date_to": "string"
    },
    "items": [
        {
            "category": "string",
            "currency": "string",
            "gmv": 0,
            "name": "string",
            "offer_id": "string",
            "position": 0,
            "sku": 0,
            "unique_search_users": 0,
            "unique_view_users": 0,
            "view_conversion": 0
        }
    ],
    "page_count": 0,
    "total": 0
}

🟠400请求有误

🟠403禁止访问

🟠404记录不存在

🟠409409

🔴500服务器错误