1. Seller
Tabcut Open API
  • 【Must-Read】About Signature
  • Data APIs
    • Item
      • Product - Ranking
      • Product - Search V1
      • Product - Search V2
      • Product - Basic Info
      • Product - SKU Info
      • Product - Video List V1
      • Product - Video List V2
      • Product - Video List V3
      • Product - Video Statistics V2
      • Product - Creator List V1
      • Product - Creator List V2
      • Product - Creator List V3
      • Product - Trend
      • Product - Sales Mode Distribution V1
      • Product - Sales Mode Distribution V2
      • Item Sales Channels Distribution
      • Product - Sales Channel Distribution V2
      • Product - Live List V1
      • Product - Live List V2
      • Product - Live List V3
      • Product - Live Statistics V1
      • Item Live Statistics V2
      • Product - Creator Statistics V1
      • Product - Creator Statistics V2
    • Item Creator
      • Creator - Search V1
      • Creator - Search V2
      • Creator - Search V3
      • Creator - Statistics V1
      • Creator - Statistics V2
      • Creator - Basic Info
      • Creator - Product List V1
      • Creator - Product List V2
      • Creator - Product List V3
      • Creator - Product Category V1
      • Item Creator Item Category V2
      • Creator - Product Category V3
      • Creator - Video Trend
      • Creator - Video Category V1
      • Creator - Video Category V2
      • Creator - Video List V1
      • Creator - Video List V2
      • Creator - Affiliate Videos
      • Creator - Trend
      • Item Creator Live List V2
      • Creator AI Insight Metrics
      • Creator - Seller List
    • Seller
      • Seller - Ranking
        GET
      • Seller - Search V1
        GET
      • Seller - Search V2
        GET
      • Seller - Search V3
        GET
      • Seller - Basic Info
        GET
      • Seller - Statistics V1
        GET
      • Seller - Statistics V2
        GET
      • Seller - Sales Distribution
        GET
      • Seller - Sales Trend
        GET
      • Seller - Promotion Trend
        GET
      • Seller - Live Data
        GET
      • Seller - Category Analysis
        GET
      • Seller - Product Category List
        GET
      • Seller - Product List V1
        GET
      • Seller - Product List V2
        GET
      • Seller - Video Category List
        GET
      • Seller - Video List
        GET
      • Seller - Live List
        GET
      • Seller - Creator List V1
        GET
      • Seller - Creator List V2
        GET
    • Item Video
      • Video - Search V1
      • Video - Search V2
      • Video - Basic Info
      • Video - Period Statistics
      • Video - AI Insight
      • Video - Product List V1
      • Video - Trend
      • Video - Play URL
      • Video - Product List V2
      • Video - Product List V3
    • Category
      • Category - Potential Category
      • Category - Market Trend
      • Category - Top 10 Categories
    • Hashtag
      • Hashtag - Search V1
      • Hashtag - Search V2
      • Hashtag - Ranking
      • Hashtag - Basic Info V1
      • Hashtag - Basic Info V2
      • Hashtag - Trend
      • Hashtag - Creator List
      • Hashtag - Video List V1
      • Hashtag - Video List V2
      • Topic Basic Info V3
    • Live
      • Live - Search
      • Live - Basic Info
      • Live - Product Category
      • Live - Product List V1
      • Live - Product List V2
      • Live - Traffic Trend
    • Data Expand
      • Data Expansion - Manual Update
  • Meta APIs
    • Translation of Item category names
    • Search Blacklist
      • Blacklist - Block
      • Blacklist - Check
      • Blacklist - List
      • Blacklist - Unblock
    • Country List
    • Item Category List
    • Metadata - TikTok Category
    • Metadata - Language List
    • Metadata - Country List
    • Metadata - Creator Category V2
    • Quota - Remaining
  • Data
    • Item
    • Category
    • Creator
  • Schemas
    • Basic result response
    • Trend series
    • Amount
    • Result response
    • Range
    • Period count
    • Sales distribution
    • Trend count
    • Distribution creator
    • Currency symbol
    • Trend point
    • Period amount
    • Video trend
    • Creator statistics
    • Video trend response
    • Creator statistics list response
  1. Seller

Seller - Product 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 'http://open.tabcut.com:8090/api/seller/v2/item_list?sellerId=&period=30d&tkCategoryLv1Id=&valid=1&sortField=soldCountPeriod&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
Bodyapplication/json

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"
}
🟢200Parameter Error
🟢200Signature Error
🟢200Server Error
Modified at 2026-09-22 07:48:44
Previous
Seller - Product List V1
Next
Seller - Video Category List
Built with