Tabcut Open API
  1. Item
Tabcut Open API
  • 【Must-Read】About Signature
  • Data APIs
    • Item
      • Item Ranking
        GET
      • Item Search
        GET
      • Item Basic
        GET
      • Item Video List
        GET
      • Item Creator List
        GET
      • Item Trend
        GET
      • Item Sales Mode Distribution
        GET
      • Item Sales Channels Distribution
        GET
    • Item Creator
      • Item Creator Statistic
      • Item Creator Basic
      • Item Creator Items
      • Item Creator Item Category
      • Item Creator Video Trend
      • Item Creator Video Category
      • Item Creator Video List
      • Item Creator Video Detail
      • Item Creator Search
      • Item Creator Trend
    • Seller
      • Seller Ranking
      • Seller Search
    • Item Video
      • Item Video Item List
      • Item Video Trend
      • Item Video Basic
      • Item Video Play Url
  • Meta APIs
    • Translation of Item category names
    • Region List
      GET
    • Item Category List
      GET
    • Tiktok Category List
      GET
  1. Item

Item Trend

GET
/api/item/trend

Request

Query Params
itemId
string 
required
Item ID
startDate
string 
required
Start date, inclusive. Format: yyyyMMdd
endDate
string 
required
End date, exclusive. Format: yyyyMMdd
Header Params
x-appKey
string 
required
Example:
{{appKey}}
x-timestamp
string 
required
Example:
{{x-timestamp}}
x-sign
string 
required
Example:
{{x-sign}}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'http://open.tabcut.com:8090/api/item/trend?itemId&startDate&endDate' \
--header 'x-appKey: ' \
--header 'x-timestamp: {{x-timestamp}}' \
--header 'x-sign: {{x-sign}}'

Responses

🟢200Success
application/json
Body
code
string 
required
message
string 
required
result
object 
required
itemId
string 
required
Product ID
itemName
string 
required
Product name
soldCountPeriod
integer 
required
Total sales volume within the period (i.e., within the selected period, the same below)
videoCountPeriod
integer 
required
Total number of associated videos within the period
userCountPeriod
integer 
required
Total number of associated influencers within the period
liveCountPeriod
integer 
required
Total number of associated live broadcasts within the period
currencySymbolInfo
object 
required
Currency symbol information
gmvInfo
object 
required
GMV information
soldCount
array [object {2}] 
required
Daily sales volume information
gmv
array [object {2}] 
required
Daily GMV information, structure defined the same as above
userCount
array [object {2}] 
required
Added influencer information, structure defined the same as above
videoCount
array [object {2}] 
required
Daily video information, structure defined the same as above
availablePrice
array [object {2}] 
required
Daily price information, structure defined the same as above
liveRoomCountPeriod
array [object {2}] 
required
Daily live room information, structure defined the same as above
localGmvPeriodList
array [object {2}] 
required
Daily local GMV information, structure defined the same as above
serverTime
string 
required
Example
{
    "code": "200",
    "message": "Success!",
    "result": {
        "itemId": "1729401326017613638",
        "itemName": "HOMELAB 3-Piece Wearable Hot Water Bottle with Waist Strap",
        "soldCountPeriod": 26091,
        "videoCountPeriod": 0,
        "userCountPeriod": 0,
        "liveCountPeriod": 0,
        "currencySymbolInfo": {
            "local": "£",
            "region": "$",
        },
        "gmvInfo": {
            "periodCurrent": {
                "local": 182376.09,
                "region": 230797.29
            },
            "period1d": null,
            "period7d": null,
            "period30d": null,
            "total": null
        },
        "soldCount": [
            {
                "date": "20231215",
                "score": 15268
            },
            {
                "date": "20231216",
                "score": 751
            },
            {
                "date": "20231217",
                "score": 439
            },
            {
                "date": "20231218",
                "score": 405
            },
            {
                "date": "20231219",
                "score": 2982
            },
            {
                "date": "20231220",
                "score": 3329
            },
            {
                "date": "20231221",
                "score": 2917
            }
        ],
        "gmv": [
            {
                "date": "20231215",
                "score": 135058.57
            },
            {
                "date": "20231216",
                "score": 6643.24
            },
            {
                "date": "20231217",
                "score": 3883.33
            },
            {
                "date": "20231218",
                "score": 3582.57
            },
            {
                "date": "20231219",
                "score": 26378.35
            },
            {
                "date": "20231220",
                "score": 29447.86
            },
            {
                "date": "20231221",
                "score": 25803.37
            }
        ],
        "userCount": [
            {
                "date": "20231215",
                "score": 0
            },
            {
                "date": "20231216",
                "score": 0
            },
            {
                "date": "20231217",
                "score": 0
            },
            {
                "date": "20231218",
                "score": 0
            },
            {
                "date": "20231219",
                "score": 0
            },
            {
                "date": "20231220",
                "score": 0
            },
            {
                "date": "20231221",
                "score": 0
            }
        ],
        "videoCount": [
            {
                "date": "20231215",
                "score": 0
            },
            {
                "date": "20231216",
                "score": 0
            },
            {
                "date": "20231217",
                "score": 0
            },
            {
                "date": "20231218",
                "score": 0
            },
            {
                "date": "20231219",
                "score": 0
            },
            {
                "date": "20231220",
                "score": 0
            },
            {
                "date": "20231221",
                "score": 0
            }
        ],
        "availablePrice": [
            {
                "date": "20231215",
                "score": 6.99
            },
            {
                "date": "20231216",
                "score": 6.99
            },
            {
                "date": "20231217",
                "score": 6.99
            },
            {
                "date": "20231218",
                "score": 6.99
            },
            {
                "date": "20231219",
                "score": 6.99
            },
            {
                "date": "20231220",
                "score": 6.99
            },
            {
                "date": "20231221",
                "score": 6.99
            }
        ],
        "liveRoomCountPeriod": [
            {
                "date": "20231215",
                "score": 0
            },
            {
                "date": "20231216",
                "score": 0
            },
            {
                "date": "20231217",
                "score": 0
            },
            {
                "date": "20231218",
                "score": 0
            },
            {
                "date": "20231219",
                "score": 0
            },
            {
                "date": "20231220",
                "score": 0
            },
            {
                "date": "20231221",
                "score": 0
            }
        ],
        "localGmvPeriodList": [
            {
                "date": "20231215",
                "score": 106723.32
            },
            {
                "date": "20231216",
                "score": 5249.49
            },
            {
                "date": "20231217",
                "score": 3068.61
            },
            {
                "date": "20231218",
                "score": 2830.95
            },
            {
                "date": "20231219",
                "score": 20844.18
            },
            {
                "date": "20231220",
                "score": 23269.71
            },
            {
                "date": "20231221",
                "score": 20389.83
            }
        ]
    },
    "serverTime": "2023-12-22 10:21:24"
}
Modified at 2025-06-24 09:17:16
Previous
Item Creator List
Next
Item Sales Mode Distribution
Built with