Item Ranking - Tabcut Open API

Request

Query Params

rankDay

integer

required

1 - Daily Ranking; 7 - Weekly Ranking; 30 - Monthly Ranking

region

string

required

Country, abbreviated in uppercase English letters. Obtained from the country list interface under metadata.

itemCategoryId

string

optional

Item category ID, an enumerated value. If not passed, all categories will be viewed. Obtained from the category interface under Meta APIs.

localPriceBegin

number

optional

Starting point of the product price (local currency), inclusive.

localPriceEnd

number

optional

End point of the product price (local currency), exclusive.

pageNo

integer

optional

Page number, default value = 1

pageSize

integer

optional

Number of items per page, default value = 10

sort

integer

required

Sorting enumeration values, all in descending order: 1 - Sales volume; 2 - Growth rate

Header Params

x-appKey

string

required

Refer【Must-Read】About Signature

Example:

x-timestamp

string

required

Refer【Must-Read】About Signature

Example:

x-sign

string

required

Refer【Must-Read】About Signature

Example:

Request samples

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}}'

Responses

🟢200成功

application/json

Body

code

string

required

message

string

required

result

object

required

total

integer

required

pageNo

integer

required

pageSize

integer

required

data

array [object {12}]

required

serverTime

string

required

Example

{
    "code": "200",
    "message": "Success",
    "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.496,
                "rank": 11,
                "currencySymbolInfo": {
                    "local": "₫",
                    "region": "$"
                },
                "priceList": [
                    {
                        "local": 159000,
                        "region": 6.52
                    }
                ],
                "fullManagedFlag": 0
            }
        ]
    },
    "serverTime": "2023-12-21 16:53:25"
}