# Tabcut Open API

## Docs
- [【Must-Read】About Signature](https://tabcut-data-api-en.apifox.cn/doc-6913299.md): 
- Meta APIs [Translation of Item category names](https://tabcut-data-api-en.apifox.cn/doc-6913301.md): 

## API Docs
- Data APIs > Item [Item Ranking](https://tabcut-data-api-en.apifox.cn/api-312636561.md): 
- Data APIs > Item [Item Search](https://tabcut-data-api-en.apifox.cn/api-312644731.md): 
- Data APIs > Item [Item - Search V2](https://tabcut-data-api-en.apifox.cn/api-429410270.md): Search for items with period-based sales data. Supports filtering by period (1d/7d/30d/90d/180d/365d), and returns core metrics including period GMV, growth rate, sold count, and creator conversion rate.
- Data APIs > Item [Item Basic](https://tabcut-data-api-en.apifox.cn/api-312636563.md): 
- Data APIs > Item [Item Specifications](https://tabcut-data-api-en.apifox.cn/api-404718312.md): Get complete item specification information, including specification attributes, price (with exchange rate conversion), stock, total stock, stock percentage, etc. Returns tree-structured data, supporting multi-specification items (e.g., color + size),When returning multi specification product data, the data of the leaf nodes shall prevail.
- Data APIs > Item [Item Video List](https://tabcut-data-api-en.apifox.cn/api-313108577.md): 
- Data APIs > Item [Item Video List V2](https://tabcut-data-api-en.apifox.cn/api-397396616.md): 
- Data APIs > Item [Item Video List V3](https://tabcut-data-api-en.apifox.cn/api-429434613.md): Retrieve the related video list for an item detail page (V3). Supports filtering by video publish date range. New metrics include video conversion rate and revenue per thousand plays. Sort fields use camelCase and support both ascending and descending order.
- Data APIs > Item [Item Video Statistics V2](https://tabcut-data-api-en.apifox.cn/api-397614807.md): Based on the product ID and video release time range, obtain statistical information on the videos associated with the product, including the number of videos, influencers, and sales volume GMV、GPM、 Advertising GMV and advertising transaction ratio data
- Data APIs > Item [Item Creator List](https://tabcut-data-api-en.apifox.cn/api-313110908.md): 
- Data APIs > Item [Item Creator List V2](https://tabcut-data-api-en.apifox.cn/api-397431545.md): 
- Data APIs > Item [Item Creator List V3](https://tabcut-data-api-en.apifox.cn/api-429444085.md): Query the associated creator list for a product (V3). Supports custom date range query, camelCase sort fields with asc/desc ordering. Adds total GMV, total sold count, and average sale price metrics.
- Data APIs > Item [Item Trend](https://tabcut-data-api-en.apifox.cn/api-313148904.md): 
- Data APIs > Item [Item Sales Mode Distribution](https://tabcut-data-api-en.apifox.cn/api-313151750.md): 
- Data APIs > Item [Item Sales Mode Distribution V2](https://tabcut-data-api-en.apifox.cn/api-395412850.md): 
- Data APIs > Item [Item Sales Channels Distribution](https://tabcut-data-api-en.apifox.cn/api-312647269.md): 
- Data APIs > Item [Item Sales Channels Distribution V2](https://tabcut-data-api-en.apifox.cn/api-395396563.md): 
- Data APIs > Item [Item Live Room List](https://tabcut-data-api-en.apifox.cn/api-392927357.md): 
- Data APIs > Item [Item Live Room List V2](https://tabcut-data-api-en.apifox.cn/api-395830125.md): 
- Data APIs > Item [Item Live Room List V3](https://tabcut-data-api-en.apifox.cn/api-429445354.md): Retrieve the list of live streams associated with a specific item within a given date range. Supports sorting by live start time, total viewers, sales volume, sales amount, conversion rate, and revenue per 1,000 views. V3 adds the revenue per 1,000 views field.
- Data APIs > Item [Item Live Statistics](https://tabcut-data-api-en.apifox.cn/api-392995502.md): Returns aggregated live metrics for the specified item and time range
- Data APIs > Item [Item Live Statistics V2](https://tabcut-data-api-en.apifox.cn/api-395833432.md): Returns aggregated live metrics for the specified item and time range
- Data APIs > Item [Item Creator Statistics](https://tabcut-data-api-en.apifox.cn/api-392997868.md): Returns creator counts and follower distribution for the specified item and time range
- Data APIs > Item [Item Creator Statistics V2](https://tabcut-data-api-en.apifox.cn/api-397470221.md): Returns creator counts and follower distribution for the specified item and time range
- Data APIs > Item Creator [Item Creator Search](https://tabcut-data-api-en.apifox.cn/api-313221786.md): 
- Data APIs > Item Creator [Item Creator Search V2](https://tabcut-data-api-en.apifox.cn/api-399188826.md): 
- Data APIs > Item Creator [Item Creator Search V3](https://tabcut-data-api-en.apifox.cn/api-435081256.md): 
- Data APIs > Item Creator [Item Creator Statistic](https://tabcut-data-api-en.apifox.cn/api-313180585.md): 
- Data APIs > Item Creator [Item Creator Statistic V2](https://tabcut-data-api-en.apifox.cn/api-435081273.md): 
- Data APIs > Item Creator [Item Creator Basic](https://tabcut-data-api-en.apifox.cn/api-313213717.md): 
- Data APIs > Item Creator [Item Creator Items](https://tabcut-data-api-en.apifox.cn/api-313214349.md): 
- Data APIs > Item Creator [Item Creator Items V2](https://tabcut-data-api-en.apifox.cn/api-397674686.md): 
- Data APIs > Item Creator [Item Creator Items V3](https://tabcut-data-api-en.apifox.cn/api-435081255.md): 
- Data APIs > Item Creator [Item Creator Item Category](https://tabcut-data-api-en.apifox.cn/api-313216676.md): 
- Data APIs > Item Creator [Item Creator Item Category V2](https://tabcut-data-api-en.apifox.cn/api-397643372.md): 
- Data APIs > Item Creator [Item Creator Item Category V3](https://tabcut-data-api-en.apifox.cn/api-435081205.md): 
- Data APIs > Item Creator [Item Creator Video Trend](https://tabcut-data-api-en.apifox.cn/api-313218444.md): 
- Data APIs > Item Creator [Item Creator Video Category](https://tabcut-data-api-en.apifox.cn/api-313218837.md): 
- Data APIs > Item Creator [Item Creator Video Category V2](https://tabcut-data-api-en.apifox.cn/api-398190093.md): 
- Data APIs > Item Creator [Item Creator Video List](https://tabcut-data-api-en.apifox.cn/api-313220501.md): 
- Data APIs > Item Creator [Item Creator Video List V2](https://tabcut-data-api-en.apifox.cn/api-398465328.md): 
- Data APIs > Item Creator [Item Creator Video Detail](https://tabcut-data-api-en.apifox.cn/api-313221234.md): 
- Data APIs > Item Creator [Item Creator Trend](https://tabcut-data-api-en.apifox.cn/api-312636576.md): 
- Data APIs > Item Creator [Item Creator Live List V2](https://tabcut-data-api-en.apifox.cn/api-398490211.md): Get creator's live streaming list by creator ID, supports pagination and sorting. V2 version uses yyyyMMdd date format (8 digits), e.g., 20241122
- Data APIs > Item Creator [Creator AI Insight Metrics](https://tabcut-data-api-en.apifox.cn/api-393611777.md): Returns creator AI insight data, including core metrics (average viewers, average views per video per user, average viewing progress, average completion rate, average new followers per video), user profiles (gender distribution, age distribution, follower ratio, repeat viewing ratio) and geographic distribution (TOP5 countries and TOP5 cities). The response includes data for all periods (7 days, 30 days, 90 days) and both video types (all videos and e-commerce videos).
- Data APIs > Item Creator [Item Creator Seller List](https://tabcut-data-api-en.apifox.cn/api-435081642.md): 
- Data APIs > Seller [Seller Ranking](https://tabcut-data-api-en.apifox.cn/api-313224467.md): 
- Data APIs > Seller [Seller Search](https://tabcut-data-api-en.apifox.cn/api-313225290.md): 
- Data APIs > Seller [Seller Search V2](https://tabcut-data-api-en.apifox.cn/api-397020395.md): 
- Data APIs > Seller [Seller - Search V3](https://tabcut-data-api-en.apifox.cn/api-429417222.md): 
- Data APIs > Seller [Seller - Basic Info](https://tabcut-data-api-en.apifox.cn/api-397020396.md): 
- Data APIs > Seller [Seller - Statistics](https://tabcut-data-api-en.apifox.cn/api-397020397.md): 
- Data APIs > Seller [Seller - Statistics V2](https://tabcut-data-api-en.apifox.cn/api-429515503.md): 
- Data APIs > Seller [Seller - Sales Distribution](https://tabcut-data-api-en.apifox.cn/api-397020398.md): 
- Data APIs > Seller [Sales Trend Analysis](https://tabcut-data-api-en.apifox.cn/api-397020399.md): 
- Data APIs > Seller [Video/Live Promotion Trend Analysis](https://tabcut-data-api-en.apifox.cn/api-397020400.md): 
- Data APIs > Seller [Live Streaming Detailed Data](https://tabcut-data-api-en.apifox.cn/api-397020401.md): 
- Data APIs > Seller [Category Analysis](https://tabcut-data-api-en.apifox.cn/api-397020402.md): 
- Data APIs > Seller [Product Category List](https://tabcut-data-api-en.apifox.cn/api-397020403.md): 
- Data APIs > Seller [Seller - Item List V1](https://tabcut-data-api-en.apifox.cn/api-397020404.md): 
- Data APIs > Seller [Seller - Item List V2](https://tabcut-data-api-en.apifox.cn/api-429516344.md): 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.
- Data APIs > Seller [Video Category List](https://tabcut-data-api-en.apifox.cn/api-397020405.md): 
- Data APIs > Seller [Video List](https://tabcut-data-api-en.apifox.cn/api-397020406.md): 
- Data APIs > Seller [Live Streaming List](https://tabcut-data-api-en.apifox.cn/api-397020407.md): 
- Data APIs > Seller [Seller - Creator List V1](https://tabcut-data-api-en.apifox.cn/api-397020408.md): 
- Data APIs > Seller [Seller - Creator List V2](https://tabcut-data-api-en.apifox.cn/api-429516961.md): 
- Data APIs > Item Video [Video Search](https://tabcut-data-api-en.apifox.cn/api-399267244.md): 
- Data APIs > Item Video [Video - Search V2](https://tabcut-data-api-en.apifox.cn/api-439288343.md): Video Search V2, based on video_search_v9 index, supports period-based filtering and sorting
- Data APIs > Item Video [Item Video Basic](https://tabcut-data-api-en.apifox.cn/api-313249702.md): 
- Data APIs > Item Video [Video - Period Statistics](https://tabcut-data-api-en.apifox.cn/api-439288171.md): 
- Data APIs > Item Video [AI Insight](https://tabcut-data-api-en.apifox.cn/api-399267245.md): 
- Data APIs > Item Video [Item Video Item List](https://tabcut-data-api-en.apifox.cn/api-313248487.md): 
- Data APIs > Item Video [Item Video Trend](https://tabcut-data-api-en.apifox.cn/api-313249155.md): 
- Data APIs > Item Video [Item Video Play Url](https://tabcut-data-api-en.apifox.cn/api-313250190.md): ### Notes
- Data APIs > Item Video [Item Video Item List V2](https://tabcut-data-api-en.apifox.cn/api-399267246.md): 
- Data APIs > Item Video [Item Video Item List V3](https://tabcut-data-api-en.apifox.cn/api-439288302.md): 
- Data APIs > Category [Category - Potential Categories](https://tabcut-data-api-en.apifox.cn/api-400481396.md): 
- Data APIs > Category [Category - Market GMV Trend](https://tabcut-data-api-en.apifox.cn/api-442505694.md): 
- Data APIs > Category [Category - Top10 Categories](https://tabcut-data-api-en.apifox.cn/api-442505802.md): 
- Data APIs > Hashtag [Hashtag Search](https://tabcut-data-api-en.apifox.cn/api-400490847.md): 
- Data APIs > Hashtag [Hashtag Search V2](https://tabcut-data-api-en.apifox.cn/api-444380232.md): 
- Data APIs > Hashtag [Topic Rank](https://tabcut-data-api-en.apifox.cn/api-400490848.md): 
- Data APIs > Hashtag [Topic Basic Info](https://tabcut-data-api-en.apifox.cn/api-400490849.md): 
- Data APIs > Hashtag [Topic Basic Info V2 (Period Aggregation)](https://tabcut-data-api-en.apifox.cn/api-444366294.md): 
- Data APIs > Hashtag [Topic Usage Trend](https://tabcut-data-api-en.apifox.cn/api-400490850.md): 
- Data APIs > Hashtag [Topic Associated Creator List](https://tabcut-data-api-en.apifox.cn/api-400490851.md): 
- Data APIs > Hashtag [Topic Associated Video list](https://tabcut-data-api-en.apifox.cn/api-400490852.md): 
- Data APIs > Hashtag [Topic Associated Video list V2](https://tabcut-data-api-en.apifox.cn/api-444366608.md): 
- Data APIs > Hashtag [Topic Basic Info V3](https://tabcut-data-api-en.apifox.cn/api-473098701.md): 
- Data APIs > Live [Live Room Search](https://tabcut-data-api-en.apifox.cn/api-402046393.md): Search for live streams with various filters (date format: yyyyMMdd)
- Data APIs > Live [Live Room Basic Information](https://tabcut-data-api-en.apifox.cn/api-402046394.md): Retrieve basic information of a live stream
- Data APIs > Live [Product Category List](https://tabcut-data-api-en.apifox.cn/api-402046395.md): Retrieve product category list of a live stream
- Data APIs > Live [Product List](https://tabcut-data-api-en.apifox.cn/api-402046396.md): Retrieve product list of a live stream
- Data APIs > Live [Product List V2](https://tabcut-data-api-en.apifox.cn/api-441172895.md): 
- Data APIs > Live [Live Room Trend](https://tabcut-data-api-en.apifox.cn/api-402046397.md): Retrieve trend analysis data of a live stream
- Data APIs > Data Expand [Data Expand - Manual Update](https://tabcut-data-api-en.apifox.cn/api-444400574.md): Manually update existing data in the database. Supports updating creators, videos, items, sellers, etc.
- Meta APIs > Search Blacklist [Search Blacklist - Block](https://tabcut-data-api-en.apifox.cn/api-453538690.md): Add objects of the specified business type to the search content blacklist in batch.
- Meta APIs > Search Blacklist [Search Blacklist - Check](https://tabcut-data-api-en.apifox.cn/api-453539227.md): Check whether a specified business object is currently in the search blacklist under the current appKey.
- Meta APIs > Search Blacklist [Search Blacklist - List](https://tabcut-data-api-en.apifox.cn/api-453539344.md): Query effective search blacklist records under the current appKey and specified business type with pagination.
- Meta APIs > Search Blacklist [Search Blacklist - Unblock](https://tabcut-data-api-en.apifox.cn/api-453539632.md): Remove objects of the specified business type from the search content blacklist in batch (soft delete: records are flagged as ineffective).
- Meta APIs [Country List](https://tabcut-data-api-en.apifox.cn/api-312636585.md): 
- Meta APIs [Item Category List](https://tabcut-data-api-en.apifox.cn/api-312636586.md): 
- Meta APIs [Tiktok Category List](https://tabcut-data-api-en.apifox.cn/api-312636587.md): 
- Meta APIs [Metadata - Language List](https://tabcut-data-api-en.apifox.cn/api-435079523.md): Returns a list of languages, each containing the corresponding list of countries
- Meta APIs [Metadata - Country List](https://tabcut-data-api-en.apifox.cn/api-435079526.md): Returns a list of countries, each containing the corresponding list of cities

## Schemas
- [通用response结构](https://tabcut-data-api-en.apifox.cn/schema-178446860.md): 
- [通用趋势数据元素结构](https://tabcut-data-api-en.apifox.cn/schema-178446861.md): 
- [GMVInfoVO](https://tabcut-data-api-en.apifox.cn/schema-232872145.md): 
- [ResultResponse?](https://tabcut-data-api-en.apifox.cn/schema-178446862.md): 
- [RangeVO](https://tabcut-data-api-en.apifox.cn/schema-234360625.md): 
- [CountVO](https://tabcut-data-api-en.apifox.cn/schema-178446863.md): 
- [DistributionVO](https://tabcut-data-api-en.apifox.cn/schema-232872146.md): 
- [TrendElementVOLong](https://tabcut-data-api-en.apifox.cn/schema-178446864.md): 
- [CreatorInfo](https://tabcut-data-api-en.apifox.cn/schema-232872147.md): 
- [CurrencySymbolVO](https://tabcut-data-api-en.apifox.cn/schema-178446865.md): 
- [TrendElementVOBigDecimal](https://tabcut-data-api-en.apifox.cn/schema-178446866.md): 
- [CurrencySymbolVO](https://tabcut-data-api-en.apifox.cn/schema-232872148.md): 
- [GmvAmountVO](https://tabcut-data-api-en.apifox.cn/schema-178446867.md): 
- [GmvInfoVO](https://tabcut-data-api-en.apifox.cn/schema-178446868.md): 
- [VideoTrendVO](https://tabcut-data-api-en.apifox.cn/schema-178446869.md): 
- [OpenApiCreatorStatisticVO](https://tabcut-data-api-en.apifox.cn/schema-178446870.md): 
- [ResultResponseVideoTrendVO](https://tabcut-data-api-en.apifox.cn/schema-178446871.md): 
- [ResultResponseListOpenApiCreatorStatisticVO](https://tabcut-data-api-en.apifox.cn/schema-178446872.md):