查询商品列表 - Ozon 数据服务平台API

提供 Shopee 离线（T+1更新）库的商品数据。支持按类目（categoryId+level）、产品类型（productType）、商品所在地（isBorder）、上架时间范围（ctimeStart/ctimeEnd）、近30天销量范围（sales30dayMin/Max）、近30天销售额范围（gmv30dayMin/Max）、价格范围（priceMin/Max）等条件筛选。入参 categoryId 和 level 由类目查询接口（queryShopeeCatData 或 queryShopeeLevel1/2/3Categories）返回。返回的商品ID（item_id）可作为入参传递给：

queryShopeeItemTrend：查看单个商品的历史趋势

queryShopeeItemTrendDetail：查看单个商品的颗粒度趋势明细

queryShopeeItemDetailBatch：批量获取商品详情

queryShopeeItemHotWord：获取商品引流词和同类目热词
可选站点：tw(台湾)、my(马来西亚)、id(印度尼西亚)、th(泰国)、ph(菲律宾)、sg(新加坡)、vn(越南)、br(巴西)。

请求参数

Authorization

API Key

在 header 添加参数

Authorization

示例：

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

Body 参数application/json必填

示例

{
    "site": "tw",
    "categoryId": 100001,
    "level": 1,
    "productType": 0,
    "isBorder": 0,
    "ctimeStart": "2025-01-01",
    "ctimeEnd": "2026-05-27",
    "sales30dayMin": 100,
    "sales30dayMax": 10000,
    "gmv30dayMin": 1000,
    "gmv30dayMax": 100000,
    "priceMin": 10,
    "priceMax": 1000,
    "sortType": 1,
    "sortOrder": "desc",
    "timest": "2026-05-26",
    "pageNo": 1,
    "pageSize": 10
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200

*/*

Body*/*

示例

{
    "success": true,
    "errorCode": "string",
    "errorMessage": "string",
    "data": [
        {
            "site": "tw",
            "itemName": "2026新款夏季连衣裙",
            "itemId": 1234567890,
            "catId": 100001,
            "catName": "Women's Clothing",
            "shopName": "Shopee Official Store",
            "productType": 1,
            "shopType": 1,
            "ctime": "2025-01-01",
            "price": 199,
            "sales": 500,
            "sales7day": 3500,
            "sales30day": 15000,
            "gmv": 50000,
            "gmv7day": 350000,
            "gmv30day": 1500000,
            "totalSales": 500000,
            "ratingStar": 4.8,
            "likeCount": 5000,
            "commentCount": 10000,
            "timest": "2026-05-26"
        }
    ],
    "total": 100,
    "pageNo": 1,
    "pageSize": 20
}