有关特定商品查询的信息

使用该方法获取特定商品的查询数据。只有 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>

可选

分析数据的结束日期。

limit_by_sku

integer <int32>

必需

单个SKU的查询数量限制。最大值为15次查询。

page

integer <int32>

可选

请求返回的页码。最小值为0。

page_size

integer <int32>

必需

每页包含的商品数量。最大值为100。

skus

array[string <int64>]

必需

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

sort_by

enum<string>

可选

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

BY_SEARCHES— 按搜索次数；

BY_VIEWS— 按浏览量；

BY_POSITION— 按商品的平均排名；

BY_CONVERSION— 按转化率；

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

只有 Premium 或 Premium Plus 订阅，才能按 BY_VIEWS、BY_POSITION 和 BY_CONVERSION 排序。

枚举值:

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",
    "limit_by_sku": 0,
    "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 (v1AnalyticsProductQueriesDetailsResponseAnalyticsPeriod)

可选

数据分析的时间范围。

date_from

string

可选

分析数据的起始日期。

date_to

string

可选

分析数据的结束日期。

page_count

integer <int64>

总页数。

可选

queries

array[object (AnalyticsProductQueriesDetailsResponseQuery) {10}]

查询列表。

可选

currency

string

货币单位。

可选

gmv

number <float>

搜索查询的销售额。

可选

order_count

integer <int64>

可选

根据查询的订单数量。

position

number <float>

可选

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

query

string

请求文本。

可选

query_index

integer <int64>

查询序号。

可选

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 订阅，否则该字段为空。

total

integer <int64>

搜索请求的总数。

可选

示例

{
    "analytics_period": {
        "date_from": "string",
        "date_to": "string"
    },
    "page_count": 0,
    "queries": [
        {
            "currency": "string",
            "gmv": 0,
            "order_count": 0,
            "position": 0,
            "query": "string",
            "query_index": 0,
            "sku": 0,
            "unique_search_users": 0,
            "unique_view_users": 0,
            "view_conversion": 0
        }
    ],
    "total": 0
}

🟠400请求有误