商品榜 - 特看数据开放api

请求参数

Query 参数

rankDay

integer

必需

1-日榜，7-周榜，30-月榜

region

string

必需

国家，英文大写字母简称。从元数据下国家列表接口获取。

itemCategoryId

string

可选

商品类目id，枚举值，不传查看全部类目。从元数据下类目接口获取。

localPriceBegin

number

可选

商品价格（当地货币）开始点，包含

localPriceEnd

number

可选

商品价格（当地货币）结束点，不包含

pageNo

integer

页码，默认值=1

可选

pageSize

integer

可选

每页条数，默认值=10

sort

integer

必需

排序枚举值，皆为倒序，1-销量，2-增长率

Header 参数

x-appKey

string

联系特看客服获取

必需

示例值:

x-timestamp

string

必需

加签时的时间戳，到毫秒

示例值:

x-sign

string

签名

必需

示例值:

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request GET 'http://open.tabcut.com:8090/api/item/ranking/list?rankDay&region&itemCategoryId&localPriceBegin&localPriceEnd&pageNo&pageSize&sort' \
--header 'x-appKey: ' \
--header 'x-timestamp: {{x-timestamp}}' \
--header 'x-sign: {{x-sign}}'

返回响应

🟢200成功

application/json

Body

code

string

必需

message

string

必需

result

object

必需

total

integer

必需

pageNo

integer

必需

pageSize

integer

必需

data

array [object {12}]

必需

serverTime

string

必需

示例

{
    "code": "200",
    "message": "成功!",
    "result": {
        "total": 500,
        "pageNo": 2,
        "pageSize": 10,
        "data": [
            {
                "itemId": "1729456355335900081",
                "itemName": "Son Kem Lì, Bền Màu, Lâu Trôi Merzy The First Velvet Tint V6 Xanh Lá Green Edition 4.5g",
                "itemPicUrl": "http://cdn.tabcut.com/dataservice/media/item/1729456355335900081/17294563553359000810.webp?auth_key=1703149405-0-0-e6055b711269c1c98a650755534c5b39&image_process=resize,fh_246,fw_246/format,png",
                "region": "VN",
                "categoryId": 2,
                "categoryName": "美妆个护",
                "soldCountPeriod": 1887,
                "soldCountGrowthRate": 1.4960,
                "rank": 11,
                "currencySymbolInfo": {
                    "local": "₫",
                    "region": "$"
                },
                "priceList": [
                    {
                        "local": 159000.00,
                        "region": 6.52
                    }
                ],
                "fullManagedFlag": 0
            }
        ]
    },
    "serverTime": "2023-12-21 16:53:25"
}