有关特定商品查询的信息

POST

/v1/analytics/product-queries/details

使用该方法获取特定商品的查询数据。只有 Premium 或 Premium Plus 订阅，才能查看完整分析数据。未订阅的用户可以查看部分指标。该方法与在个人中心的 搜索中的商品 → 我的商品查询 选项卡查看商品数据类似。

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

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

请求参数

Header 参数

Body 参数application/json

示例

{
    "date_from": "2019-08-24T14:15:22.123Z",
    "date_to": "2019-08-24T14:15:22.123Z",
    "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

curl --location --request POST 'https://api-seller.ozon.ru/v1/analytics/product-queries/details' \
--header 'Client-Id;' \
--header 'Api-Key;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "date_from": "2019-08-24T14:15:22.123Z",
    "date_to": "2019-08-24T14:15:22.123Z",
    "limit_by_sku": 0,
    "page": 0,
    "page_size": 0,
    "skus": [
        "string"
    ],
    "sort_by": "BY_SEARCHES",
    "sort_dir": "DESCENDING"
}'

返回响应

🟢200成功

application/json

有关特定商品查询的信息

Body

示例

{
    "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请求有误

修改于 2025-06-10 08:30:31

获取商品搜索查询信息

每日商品销售报告