1. Seller
Tabcut Open API
  • 【Must-Read】About Signature
  • Data APIs
    • Item
      • Item Ranking
      • Item Search
      • Item Search V2
      • Item Basic
      • Item Specifications
      • Item Video List
      • Item Video List V2
      • Item Video List V3
      • Item Video Statistics V2
      • Item Creator List
      • Item Creator List V2
      • Item Creator List V3
      • Item Trend
      • Item Sales Mode Distribution
      • Item Sales Mode Distribution V2
      • Item Sales Channels Distribution
      • Item Sales Channels Distribution V2
      • Item Live Room List
      • Item Live Room List V2
      • Item Live Room List V3
      • Item Live Statistics
      • Item Live Statistics V2
      • Item Creator Statistics
      • Item Creator Statistics V2
    • Item Creator
      • Item Creator Search
      • Item Creator Search V2
      • Item Creator Search V3
      • Item Creator Statistic
      • Item Creator Statistic V2
      • Item Creator Basic
      • Item Creator Items
      • Item Creator Items V2
      • Item Creator Items V3
      • Item Creator Item Category
      • Item Creator Item Category V2
      • Item Creator Item Category V3
      • Item Creator Video Trend
      • Item Creator Video Category
      • Item Creator Video Category V2
      • Item Creator Video List
      • Item Creator Video List V2
      • Item Creator Video Detail
      • Item Creator Trend
      • Item Creator Live List V2
      • Creator AI Insight Metrics
      • Item Creator Seller List
    • Seller
      • Seller Ranking
        GET
      • Seller Search
        GET
      • Seller Search V2
        GET
      • Seller - Search V3
        GET
      • Seller - Basic Info
        GET
      • Seller - Statistics
        GET
      • Seller - Statistics V2
        GET
      • Seller - Sales Distribution
        GET
      • Sales Trend Analysis
        GET
      • Video/Live Promotion Trend Analysis
        GET
      • Live Streaming Detailed Data
        GET
      • Category Analysis
        GET
      • Product Category List
        GET
      • Seller - Item List V1
        GET
      • Seller - Item List V2
        GET
      • Video Category List
        GET
      • Video List
        GET
      • Live Streaming List
        GET
      • Seller - Creator List V1
        GET
      • Seller - Creator List V2
        GET
    • Item Video
      • Video Search
      • Item Video Basic
      • AI Insight
      • Item Video Item List
      • Item Video Trend
      • Item Video Play Url
      • Item Video Item List V2
    • Category
      • Potential Category List
    • Hashtag
      • Hashtag Search
      • Topic Rank
      • Topic Basic Info
      • Topic Usage Trend
      • Topic Associated Creator List
      • Topic Associated Video list
    • Live
      • Live Search
      • Live Room Basic
      • Product Category List
      • Product List
      • Live Room Trend
  • Meta APIs
    • Translation of Item category names
    • Country List
    • Item Category List
    • Tiktok Category List
    • Metadata - Language List
    • Metadata - Country List
  • Schemas
    • 通用response结构
    • 通用趋势数据元素结构
    • GMVInfoVO
    • ResultResponse?
    • RangeVO
    • CountVO
    • DistributionVO
    • TrendElementVOLong
    • sales distribution Creator info
    • Currency Symbol Info
    • TrendElementVOBigDecimal
    • CurrencySymbolVO
    • GmvAmountVO
    • GmvInfoVO
    • VideoTrendVO
    • OpenApiCreatorStatisticVO
    • ResultResponseVideoTrendVO
    • ResultResponseListOpenApiCreatorStatisticVO
  1. Seller

Seller - Item List V2

GET
/api/seller/v2/item_list
Retrieve the associated item list of a specified seller within a given statistics period. Supports filtering by category and item status, and sorting by sales volume, GMV, price, discover time, or commission rate.

Request

Query Params

Header Params

Request Code 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/seller/v2/item_list?sellerId=&period=30d&tkCategoryLv1Id=&valid=1&sortField=soldCount&sortType=desc&pageNo=1&pageSize=10' \
--header 'x-appKey: ' \
--header 'x-timestamp: {{x-timestamp}}' \
--header 'x-sign: {{x-sign}}' \
--header 'x-selected-lng: ja-JP'

Responses

🟢200Success
application/json
Body

Example
{
    "code": "200",
    "message": "Success!",
    "result": {
        "total": 0,
        "pageNo": 0,
        "pageSize": 0,
        "data": [
            {
                "itemId": "string",
                "itemName": "string",
                "itemCoverUrl": "string",
                "itemCategoryId": 0,
                "itemCategoryName": "string",
                "region": "string",
                "priceList": [
                    {
                        "local": 0,
                        "region": 0
                    }
                ],
                "discoverTime": "string",
                "commissionRate": 0,
                "valid": 0,
                "currencySymbolInfo": {
                    "local": "string",
                    "region": "string"
                },
                "soldCountPeriod": 0,
                "gmvInfoPeriod": {
                    "periodCurrent": {
                        "local": 0,
                        "region": 0
                    },
                    "period1d": {
                        "local": 0,
                        "region": 0
                    },
                    "period7d": {
                        "local": 0,
                        "region": 0
                    },
                    "period30d": {
                        "local": 0,
                        "region": 0
                    },
                    "period90d": {
                        "local": 0,
                        "region": 0
                    },
                    "period180d": {
                        "local": 0,
                        "region": 0
                    },
                    "period365d": {
                        "local": 0,
                        "region": 0
                    },
                    "total": {
                        "local": 0,
                        "region": 0
                    }
                },
                "soldCountGrowthRate": 0,
                "localGmvGrowthRate": 0
            }
        ]
    },
    "serverTime": "2026-03-18 10:00:00"
}
Modified at 2026-03-18 03:48:03
Previous
Seller - Item List V1
Next
Video Category List
Built with