- 【Must-Read】About Signature
- Data APIs
- Item
- Item Creator
- Seller
- Item Video
- Meta APIs
Item Trend
GET
/api/item/trend
Request
Query Params
itemId
string
required
startDate
string
required
endDate
string
required
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
itemName
string
required
soldCountPeriod
integer
required
videoCountPeriod
integer
required
userCountPeriod
integer
required
liveCountPeriod
integer
required
currencySymbolInfo
object
required
gmvInfo
object
required
soldCount
array [object {2}]
required
gmv
array [object {2}]
required
userCount
array [object {2}]
required
videoCount
array [object {2}]
required
availablePrice
array [object {2}]
required
liveRoomCountPeriod
array [object {2}]
required
localGmvPeriodList
array [object {2}]
required
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