查询站点基础数据

POST

/api/shopee/site/date/query

查询某个站点的基础大盘数据，提供 Shopee 离线（T+1更新）库的站点数据。返回该站点的销量、销售额、在线商品数、客单价等宏观指标。该接口是站点级分析的入口，获取大盘概览后可：

通过 queryShopeeCatData 下钻到类目级别分析

通过 queryShopeeCatTrend 查看具体类目的历史趋势
最长支持过去720天。
必填参数：site（站点）、startDate（开始日期）、endDate（结束日期）。
可选站点：tw(台湾)、my(马来西亚)、id(印度尼西亚)、th(泰国)、ph(菲律宾)、sg(新加坡)、vn(越南)、br(巴西)。

请求参数

Authorization

API Key

在 header 添加参数

Authorization

示例：

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

Body 参数application/json必填

示例

{
    "site": "tw",
    "startDate": "2026-05-01",
    "endDate": "2026-05-26",
    "pageNo": 1,
    "pageSize": 10
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/api/shopee/site/date/query' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "site": "tw",
    "startDate": "2026-05-01",
    "endDate": "2026-05-26",
    "pageNo": 1,
    "pageSize": 10
}'

返回响应

🟢200

*/*

Body*/*

示例

{
    "success": true,
    "errorCode": "string",
    "errorMessage": "string",
    "data": [
        {
            "date": "2026-05-26",
            "site": "tw",
            "shopCount": 50000,
            "activeShopCount": 30000,
            "itemCount": 1000000,
            "activeItemCount": 600000,
            "sales30day": 5000000,
            "gmv30day": 250000000
        }
    ],
    "total": 100,
    "pageNo": 1,
    "pageSize": 20
}

修改于 2026-06-09 10:18:34

查询热搜词列表

查询店铺趋势快照