> ## Documentation Index > Fetch the complete documentation index at: https://docs.keyapi.ai/llms.txt > Use this file to discover all available pages before exploring further. # Live List -EchoTik > Search offline TikTok live streams with filters such as region, creator ID, unique_id, live type, live status, sales flag, live time range, creator category, sorting, sales, duration, and views. The response is oriented toward live commerce analysis and includes room, creator, sales, GMV, products, and audience metrics.
🪙 1 creditper request
## Copy for AI

🤖 Why Code When AI Can Do It For You?

Stop writing code like it's 1970! Let AI do the heavy lifting - click the sparkles to copy a perfectly formatted prompt for ChatGPT, Claude, or your favorite AI assistant.

## OpenAPI ````yaml en/tiktok.openapi.json GET /v1/tiktok/live/list/analytics openapi: 3.0.1 info: title: Tiktok API english documentation description: >- The english reference documentation of the Tiktok API includes the interface's purpose, parameter description, response status, and sample structure. version: 1.0.0 servers: - url: https://api.keyapi.ai description: Production security: [] tags: - name: TikTok Influencer - name: TikTok Shop - name: TikTok Content - name: TikTok Intelligence paths: /v1/tiktok/live/list/analytics: get: tags: - TikTok Content summary: Live List -EchoTik description: >- Search offline TikTok live streams with filters such as region, creator ID, unique_id, live type, live status, sales flag, live time range, creator category, sorting, sales, duration, and views. The response is oriented toward live commerce analysis and includes room, creator, sales, GMV, products, and audience metrics. parameters: - name: region in: query description: Region code, such as US. required: true example: US schema: type: string example: US - name: page_num in: query description: Page number, starting from 1. Maximum 100000. required: true example: 1 schema: type: integer example: 1 - name: page_size in: query description: Page size. Maximum 10. required: true example: 10 schema: type: integer example: 10 - name: user_id in: query description: Filter by creator ID. required: false example: '' schema: type: string example: '' - name: unique_id in: query description: Filter by creator unique ID. required: false example: '' schema: type: string example: '' - name: live_type in: query description: 'Live type: 1=shop live, 2=personal live.' required: false example: '' schema: type: integer example: '' - name: live_status in: query description: 'Live status: 2=live, 4=ended.' required: false example: '' schema: type: integer example: '' - name: sales_flag in: query description: 'Sales flag: 0=non-commerce, 1=commerce.' required: false example: '' schema: type: integer example: '' - name: min_create_time in: query description: Minimum live creation time. required: false example: '' schema: type: integer example: '' - name: max_create_time in: query description: Maximum live creation time. required: false example: '' schema: type: integer example: '' - name: category in: query description: Creator category filter. required: false example: '' schema: type: string example: '' - name: live_sort_field in: query description: >- Sort field: 1=create_time, 2=total_sale_cnt, 3=total_user_cnt, 4=max_user_count_cnt. required: false example: '' schema: type: integer example: '' - name: sort_type in: query description: 'Sort order: 0=asc, 1=desc.' required: false example: '' schema: type: integer example: '' - name: min_total_sale_cnt in: query description: Minimum live sales count. required: false example: '' schema: type: integer example: '' - name: max_total_sale_cnt in: query description: Maximum live sales count. required: false example: '' schema: type: integer example: '' - name: min_duration in: query description: Minimum live duration. required: false example: '' schema: type: integer example: '' - name: max_duration in: query description: Maximum live duration. required: false example: '' schema: type: integer example: '' - name: min_total_views_cnt in: query description: Minimum live views. required: false example: '' schema: type: integer example: '' - name: max_total_views_cnt in: query description: Maximum live views. required: false example: '' schema: type: integer example: '' responses: '200': description: '' content: application/json: schema: type: object properties: code: type: integer message: type: string data: type: array items: type: object properties: avatar: type: string description: 达人头像 category: type: string description: 达人分类 cover_url: type: string description: 直播间封面 create_time: type: integer description: 直播创建时间 duration: type: integer description: 直播时长 finish_time: type: integer description: 直播结束时间 followers_growth_rate: type: number description: 粉丝增长率 gpm: type: integer ifl_most_category_product: type: string description: 达人主要带货分类 live_sale_top3_product: type: string description: 直播top3商品 live_status: type: integer description: 直播状态 2=进行中，4=已结束 live_type: type: integer description: 直播类型， 1=店铺播， 2=个人播 max_views_cnt: type: integer description: 在线峰值 nick_name: type: string description: 达人昵称 per_live_sale_30d_cnt: type: integer description: 达人近30天直播销量 per_live_sale_gmv_30d_amt: type: number description: 达人近30天直播销售额 product_category_gmv_distribution: type: string description: 产品分类GMV分布 product_category_quantity_distribution: type: string description: 产品分类数量分布 region: type: string description: 地区 room_id: type: string description: 直播间ID sales_flag: type: integer description: 是否带货， 1=带货 0=非带货 spu_avg_price: type: integer description: 直播产品均价 title: type: string description: 直播间标题 total_active_product_cnt: type: integer description: 动销产品数 total_followers_growth_cnt: type: integer description: 粉丝增长数 total_ifl_digg_cnt: type: integer description: 达人总点赞量 total_ifl_followers_cnt: type: integer description: 达人总粉丝量 total_ifl_post_video_cnt: type: integer description: 达人总发布视频数 total_live_30d_cnt: type: integer description: 达人最近30天直播数 total_live_commerce_30d_cnt: type: integer description: 达人最近30天带货直播数 total_product_cnt: type: integer description: 直播总商品数 total_sale_cnt: type: integer description: 直播总销量 total_sale_gmv_amt: type: integer description: 直播总GMV total_views_cnt: type: integer description: 观看人次 unique_id: type: string description: 达人ID user_id: type: string description: 达人ID requestId: type: string required: - code - message - data - requestId example: code: 0 message: success data: - avatar: >- https://echosell-images.tos-ap-southeast-1.volces.com/user-avatar/92/MS4wLjABAAAARbAbXQxL5Y226gRq9oF3-gC6noCYK4mBquMHk55r9Jxje5JytDImFa2P-r4yV7ro.jpeg category: Shopping & Retail cover_url: '' create_time: 1758476363 duration: 84090 finish_time: 1758560453 followers_growth_rate: 0.003482208132624495 gpm: 0 ifl_most_category_product: >- [{ "category_name":"Beauty & Personal Care","category_id":"601450"}] live_sale_top3_product: '[]' live_status: 4 live_type: 1 max_views_cnt: 924 nick_name: Based Bodyworks per_live_sale_30d_cnt: 100 per_live_sale_gmv_30d_amt: 2894.745 product_category_gmv_distribution: '[]' product_category_quantity_distribution: '[]' region: US room_id: '7552598204001405710' sales_flag: 0 spu_avg_price: 0 title: HOT DEALS ON ALL PRODUCTS!! total_active_product_cnt: 0 total_followers_growth_cnt: 4101 total_ifl_digg_cnt: 31987286 total_ifl_followers_cnt: 1198818 total_ifl_post_video_cnt: 5937 total_live_30d_cnt: 27 total_live_commerce_30d_cnt: 4 total_product_cnt: 0 total_sale_cnt: 0 total_sale_gmv_amt: 0 total_views_cnt: 281956 unique_id: based user_id: '7153432386608251946' - avatar: >- https://echosell-images.tos-ap-southeast-1.volces.com/user-avatar/959/MS4wLjABAAAATZQ4SyFsdzAFGEUEqnRTGKUdwhgKIEbuNgNFi6R8UqdqNOTBi50mUMPh9RAQPbl8.jpeg category: Other cover_url: '' create_time: 1758500543 duration: 289253 finish_time: 1758789796 followers_growth_rate: 0.0010308853243165231 gpm: 0 ifl_most_category_product: '[{ "category_name":"Kitchenware","category_id":"600024"}]' live_sale_top3_product: '[]' live_status: 4 live_type: 2 max_views_cnt: 230 nick_name: niknikspeaks48 per_live_sale_30d_cnt: 0 per_live_sale_gmv_30d_amt: 0 product_category_gmv_distribution: '[]' product_category_quantity_distribution: '[]' region: US room_id: '7552702288578677535' sales_flag: 0 spu_avg_price: 0 title: '' total_active_product_cnt: 0 total_followers_growth_cnt: 88 total_ifl_digg_cnt: 897029 total_ifl_followers_cnt: 145726 total_ifl_post_video_cnt: 611 total_live_30d_cnt: 15 total_live_commerce_30d_cnt: 0 total_product_cnt: 0 total_sale_cnt: 0 total_sale_gmv_amt: 0 total_views_cnt: 31288 unique_id: niknikspeaks50 user_id: '6807177153626063878' - avatar: >- https://echosell-images.tos-ap-southeast-1.volces.com/user-avatar/625/MS4wLjABAAAAmMJ9S9i04-nNeHW7nftjaGMfXADP4N41uCOpL6OPORdF2HAlFDRmAPmn0agUFb3e.jpeg category: Beauty cover_url: '' create_time: 1758531724 duration: 37207 finish_time: 1758568931 followers_growth_rate: 0.008544087491455913 gpm: 3.201 ifl_most_category_product: >- [{ "category_name":"Womenswear & Underwear","category_id":"601152"}] live_sale_top3_product: >- [{ "product_id":"1729534052359573519","rn":2,"product_name":"Two-Piece Matching Set Women's Solid Pants Set, Casual Half Zip Pullover & Drawstring Waist Pants, Fashion Breathable Outfits for Daily Outdoor Wear, Ladies Fall Clothes","cover_url":"https://echosell-images.tos-ap-southeast-1.volces.com/product-cover/993/1729534052359573519_0.jpeg","total_sale_cnt":116,"total_sale_gmv_amt":1531.20},{ "product_id":"1729539003064422956","rn":3,"product_name":"Women's Plain Drawstring Hooded Tank Dress, Casual Pocket Sleeveless Maxi Dress for Summer, Fashion Women's Clothing for Daily Wear","cover_url":"https://echosell-images.tos-ap-southeast-1.volces.com/product-cover/143/1729539003064422956_0.jpeg","total_sale_cnt":100,"total_sale_gmv_amt":1444.00},{ "product_id":"1729859742505669442","rn":1,"product_name":"Two-piece Set Women's Colorblock Round Neck Tee & Plain Skinny Pants, Casual Long Sleeve T-shirt & Trousers for Fall & Winter, Women's Clothes for Daily Wear","cover_url":"https://echosell-images.tos-ap-southeast-1.volces.com/product-cover/525/1729859742505669442_0.jpeg","total_sale_cnt":155,"total_sale_gmv_amt":1498.85}] live_status: 4 live_type: 2 max_views_cnt: 190 nick_name: highlanddaily1 per_live_sale_30d_cnt: 18 per_live_sale_gmv_30d_amt: 351.246905 product_category_gmv_distribution: >- [{ "category_id":"603014","cnt":200.23},{ "category_id":"601152","cnt":10786.85}] product_category_quantity_distribution: >- [{ "category_id":"601152","cnt":81},{ "category_id":"603014","cnt":22}] region: US room_id: '7552835575233907470' sales_flag: 1 spu_avg_price: 21.891456 title: 'Pre sale deal $18.65 #fashion' total_active_product_cnt: 5 total_followers_growth_cnt: 95 total_ifl_digg_cnt: 26565 total_ifl_followers_cnt: 12454 total_ifl_post_video_cnt: 517 total_live_30d_cnt: 24 total_live_commerce_30d_cnt: 9 total_product_cnt: 103 total_sale_cnt: 6 total_sale_gmv_amt: 114.04 total_views_cnt: 35622 unique_id: highlanddaily1 user_id: '7291972001835992106' - avatar: >- https://echosell-images.tos-ap-southeast-1.volces.com/user-avatar/92/MS4wLjABAAAARbAbXQxL5Y226gRq9oF3-gC6noCYK4mBquMHk55r9Jxje5JytDImFa2P-r4yV7ro.jpeg category: Shopping & Retail cover_url: '' create_time: 1758638626 duration: 53801 finish_time: 1758692427 followers_growth_rate: 0.0015059146445551299 gpm: 258.665 ifl_most_category_product: >- [{ "category_name":"Beauty & Personal Care","category_id":"601450"}] live_sale_top3_product: >- [{ "product_id":"1730533108939526454","rn":3,"product_name":"BASED Curl Cream | Instant Definition & Hydration | Simple, Effective, BASED.","cover_url":"https://echosell-images.tos-ap-southeast-1.volces.com/product-cover/590/1730533108939526454_0.jpeg","total_sale_cnt":200,"total_sale_gmv_amt":5919.00},{ "product_id":"1729707172352594230","rn":1,"product_name":"BASED Leave-in Conditioner | Instant Hydration & Anti-Frizz | Simple, Effective, BASED.","cover_url":"https://echosell-images.tos-ap-southeast-1.volces.com/product-cover/948/1729707172352594230_0.jpeg","total_sale_cnt":300,"total_sale_gmv_amt":7819.00},{ "product_id":"1730341031414305078","rn":2,"product_name":"BASED Hair Clay - Strong Hold Matte Finish 3oz Jar Non-Toxic Shea Butter Beeswax Essential Clays Best Seller","cover_url":"https://echosell-images.tos-ap-southeast-1.volces.com/product-cover/111/1730341031414305078_0.jpeg","total_sale_cnt":300,"total_sale_gmv_amt":9684.00}] live_status: 4 live_type: 1 max_views_cnt: 420 nick_name: BASED per_live_sale_30d_cnt: 100 per_live_sale_gmv_30d_amt: 2894.745 product_category_gmv_distribution: '[{ "category_id":"601450","cnt":71258.10}]' product_category_quantity_distribution: '[{ "category_id":"601450","cnt":20}]' region: US room_id: '7553294789148494647' sales_flag: 1 spu_avg_price: 34.319 title: HOT DEALS ON ALL PRODUCTS!! total_active_product_cnt: 20 total_followers_growth_cnt: 1765 total_ifl_digg_cnt: 32124619 total_ifl_followers_cnt: 1201965 total_ifl_post_video_cnt: 5943 total_live_30d_cnt: 28 total_live_commerce_30d_cnt: 4 total_product_cnt: 20 total_sale_cnt: 927 total_sale_gmv_amt: 31808.5 total_views_cnt: 122972 unique_id: based user_id: '7153432386608251946' - avatar: >- https://echosell-images.tos-ap-southeast-1.volces.com/user-avatar/981/MS4wLjABAAAA5j020zeVMpiKKC4QHGWrDDHLn3G4hn575Yg_MUjNy5Li0lLtcaMp8Ei-obSejGL2.jpeg category: Shopping & Retail cover_url: '' create_time: 1758643279 duration: 35951 finish_time: 1758679230 followers_growth_rate: 0.001418470575437833 gpm: 687.542 ifl_most_category_product: '[{ "category_name":"Health","category_id":"700645"}]' live_sale_top3_product: >- [{ "product_id":"1729587715576533677","rn":2,"product_name":"Micro Ingredients Multi Collagen Complex, 240 Capsules","cover_url":"https://echosell-images.tos-ap-southeast-1.volces.com/product-cover/545/1729587715576533677_0.jpeg","total_sale_cnt":200,"total_sale_gmv_amt":4582.00},{ "product_id":"1731272430020367021","rn":3,"product_name":"Micro Ingredients Saffron+ Advanced Supplements, 60 Veggie Capsules","cover_url":"https://echosell-images.tos-ap-southeast-1.volces.com/product-cover/831/1731272430020367021_0.jpeg","total_sale_cnt":200,"total_sale_gmv_amt":3690.00},{ "product_id":"1729385055232561837","rn":1,"product_name":"Micro Ingredients Oregano Oil with Black Seed Oil","cover_url":"https://echosell-images.tos-ap-southeast-1.volces.com/product-cover/336/1729385055232561837_0.jpeg","total_sale_cnt":400,"total_sale_gmv_amt":9580.00}] live_status: 4 live_type: 1 max_views_cnt: 183 nick_name: Micro Ingredients per_live_sale_30d_cnt: 17 per_live_sale_gmv_30d_amt: 422.304196 product_category_gmv_distribution: >- [{ "category_id":"0","cnt":119.90},{ "category_id":"601450","cnt":0.00},{ "category_id":"700645","cnt":42999.29},{ "category_id":"700437","cnt":6044.44}] product_category_quantity_distribution: >- [{ "category_id":"700437","cnt":13},{ "category_id":"0","cnt":3},{ "category_id":"700645","cnt":66},{ "category_id":"601450","cnt":2}] region: US room_id: '7553314385486891806' sales_flag: 1 spu_avg_price: 32.947857 title: Warehouse Mega Deals! Only Today total_active_product_cnt: 47 total_followers_growth_cnt: 326 total_ifl_digg_cnt: 344356 total_ifl_followers_cnt: 231846 total_ifl_post_video_cnt: 2289 total_live_30d_cnt: 28 total_live_commerce_30d_cnt: 5 total_product_cnt: 84 total_sale_cnt: 542 total_sale_gmv_amt: 15625.77 total_views_cnt: 22727 unique_id: microingredients user_id: '7020903789716997126' - avatar: >- https://echosell-images.tos-ap-southeast-1.volces.com/user-avatar/230/MS4wLjABAAAArGa17UdF3NmpiiSOYX8yWQn51zceH59L9kBaf5ZhW_j_ghHB-q34eny6a_uRiBsA.jpeg category: Shopping & Retail cover_url: '' create_time: 1758652515 duration: 5478 finish_time: 1758657993 followers_growth_rate: 0.00013624946684991231 gpm: 48.639 ifl_most_category_product: '[{ "category_name":"Collectibles","category_id":"951432"}]' live_sale_top3_product: >- [{ "product_id":"1731817992820658184","rn":1,"product_name":"THE MONSTERS - Exciting Macaron Vinyl Face, Blind Box-8","cover_url":"https://p19-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/90d8dbce160d4c36950381f8eb69ac22~tplv-fhlh96nyum-resize-webp:800:800.webp?dr=12185&t=555f072d&ps=933b5bde&shp=cc6bf678&shcp=9b759fb9&idc=useast5&from=3429627512","total_sale_cnt":104,"total_sale_gmv_amt":2910.96},{ "product_id":"1731772972649713672","rn":3,"product_name":"POP BEAN Coffee Factory Series-Plush Pendant","cover_url":"https://echosell-images.tos-ap-southeast-1.volces.com/product-cover/973/1731772972649713672_0.jpeg","total_sale_cnt":40,"total_sale_gmv_amt":2092.26},{ "product_id":"1731811314648059912","rn":2,"product_name":"THE MONSTERS Big into Energy Series-Vinyl Plush Pendant Blind Box -9","cover_url":"https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/3f90b7270edc4134a10b03487854e9c4~tplv-fhlh96nyum-resize-webp:800:800.webp?dr=12185&t=555f072d&ps=933b5bde&shp=cc6bf678&shcp=9b759fb9&idc=useast5&from=3429627512","total_sale_cnt":80,"total_sale_gmv_amt":2239.20}] live_status: 4 live_type: 1 max_views_cnt: 2252 nick_name: POP MART US SHOP per_live_sale_30d_cnt: 41 per_live_sale_gmv_30d_amt: 3003.922269 product_category_gmv_distribution: >- [{ "category_id":"951432","cnt":3549.61},{ "category_id":"604206","cnt":15901.07},{ "category_id":"600001","cnt":0.00},{ "category_id":"0","cnt":10356.30}] product_category_quantity_distribution: >- [{ "category_id":"604206","cnt":57},{ "category_id":"600001","cnt":1},{ "category_id":"0","cnt":4},{ "category_id":"951432","cnt":33}] region: US room_id: '7553354709495450381' sales_flag: 1 spu_avg_price: 98.410947 title: New Launch Day! total_active_product_cnt: 13 total_followers_growth_cnt: 115 total_ifl_digg_cnt: 4777161 total_ifl_followers_cnt: 854390 total_ifl_post_video_cnt: 1100 total_live_30d_cnt: 29 total_live_commerce_30d_cnt: 8 total_product_cnt: 95 total_sale_cnt: 24 total_sale_gmv_amt: 2400.99 total_views_cnt: 49363 unique_id: popmart.usshop user_id: '7288986759428588590' - avatar: >- https://echosell-images.tos-ap-southeast-1.volces.com/user-avatar/230/MS4wLjABAAAArGa17UdF3NmpiiSOYX8yWQn51zceH59L9kBaf5ZhW_j_ghHB-q34eny6a_uRiBsA.jpeg category: Shopping & Retail cover_url: '' create_time: 1758658007 duration: 42819 finish_time: 1758700826 followers_growth_rate: 0.0012710529246063053 gpm: 149.561 ifl_most_category_product: '[{ "category_name":"Collectibles","category_id":"951432"}]' live_sale_top3_product: >- [{ "product_id":"1731811314648059912","rn":2,"product_name":"THE MONSTERS Big into Energy Series-Vinyl Plush Pendant Blind Box -9","cover_url":"https://p19-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/3f90b7270edc4134a10b03487854e9c4~tplv-fhlh96nyum-resize-webp:800:800.webp?dr=12185&t=555f072d&ps=933b5bde&shp=cc6bf678&shcp=9b759fb9&idc=useast5&from=3429627512","total_sale_cnt":858,"total_sale_gmv_amt":24015.42},{ "product_id":"1731312857492918280","rn":3,"product_name":"HACIPUPU Gummy Bear Series-Vinyl Plush Pendant Blind Box","cover_url":"https://echosell-images.tos-ap-southeast-1.volces.com/product-cover/115/1731312857492918280_0.jpeg","total_sale_cnt":700,"total_sale_gmv_amt":61581.00},{ "product_id":"1731817992820658184","rn":1,"product_name":"THE MONSTERS - Exciting Macaron Vinyl Face, Blind Box-8","cover_url":"https://p19-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/90d8dbce160d4c36950381f8eb69ac22~tplv-fhlh96nyum-resize-webp:800:800.webp?dr=12185&t=555f072d&ps=933b5bde&shp=cc6bf678&shcp=9b759fb9&idc=useast5&from=3429627512","total_sale_cnt":1046,"total_sale_gmv_amt":29277.54}] live_status: 4 live_type: 1 max_views_cnt: 3398 nick_name: POP MART US SHOP per_live_sale_30d_cnt: 41 per_live_sale_gmv_30d_amt: 3003.922269 product_category_gmv_distribution: >- [{ "category_id":"0","cnt":92039.09},{ "category_id":"600001","cnt":0.00},{ "category_id":"951432","cnt":49643.51},{ "category_id":"604206","cnt":213773.52}] product_category_quantity_distribution: >- [{ "category_id":"951432","cnt":34},{ "category_id":"604206","cnt":73},{ "category_id":"600001","cnt":1},{ "category_id":"0","cnt":5}] region: US room_id: '7553378333992553229' sales_flag: 1 spu_avg_price: 95.143451 title: New Launch Day! total_active_product_cnt: 59 total_followers_growth_cnt: 1073 total_ifl_digg_cnt: 4777161 total_ifl_followers_cnt: 854390 total_ifl_post_video_cnt: 1100 total_live_30d_cnt: 29 total_live_commerce_30d_cnt: 8 total_product_cnt: 113 total_sale_cnt: 539 total_sale_gmv_amt: 48119.94 total_views_cnt: 321741 unique_id: popmart.usshop user_id: '7288986759428588590' - avatar: >- https://echosell-images.tos-ap-southeast-1.volces.com/user-avatar/609/MS4wLjABAAAAFw4IcnP8Vv7Loe0P-29uL75tFn0Qx6RQMQfpD7qT5wRTVyMc8d28A9xr1e87N21y.jpeg category: Shopping & Retail cover_url: '' create_time: 1758663870 duration: 144912 finish_time: 1758808782 followers_growth_rate: 0.00046000981354268894 gpm: 26.319 ifl_most_category_product: '[{ "category_name":"Collectibles","category_id":"951432"}]' live_sale_top3_product: >- [{ "product_id":"1731658984373850467","rn":2,"product_name":"Pokemon Trading Card Game - Black Bolt OR White Flare Booster Bundle - 6 Booster Packs","cover_url":"https://echosell-images.tos-ap-southeast-1.volces.com/product-cover/593/1731658984373850467_0.jpeg","total_sale_cnt":14,"total_sale_gmv_amt":749.86},{ "product_id":"1730820472169795939","rn":1,"product_name":"Pokemon Trading Card Game - Prismatic Evolutions Booster Bundle - 6 Booster Packs","cover_url":"https://echosell-images.tos-ap-southeast-1.volces.com/product-cover/644/1730820472169795939_0.jpeg","total_sale_cnt":21,"total_sale_gmv_amt":1428.00},{ "product_id":"1731794345617363299","rn":3,"product_name":"Kakawow Phantom - Disney 2025 - Booster Box - 10 Booster Packs","cover_url":"https://echosell-images.tos-ap-southeast-1.volces.com/product-cover/536/1731794345617363299_0.jpeg","total_sale_cnt":10,"total_sale_gmv_amt":1349.90}] live_status: 4 live_type: 1 max_views_cnt: 45 nick_name: Going Twice per_live_sale_30d_cnt: 2 per_live_sale_gmv_30d_amt: 205.675172 product_category_gmv_distribution: >- [{ "category_id":"0","cnt":259.98},{ "category_id":"951432","cnt":5704.60}] product_category_quantity_distribution: >- [{ "category_id":"951432","cnt":28},{ "category_id":"0","cnt":1}] region: US room_id: '7553402890707143455' sales_flag: 1 spu_avg_price: 85.684483 title: Super Live! total_active_product_cnt: 3 total_followers_growth_cnt: 24 total_ifl_digg_cnt: 426300 total_ifl_followers_cnt: 66102 total_ifl_post_video_cnt: 838 total_live_30d_cnt: 10 total_live_commerce_30d_cnt: 1 total_product_cnt: 29 total_sale_cnt: 5 total_sale_gmv_amt: 359.31 total_views_cnt: 13652 unique_id: goingtwicecards user_id: '6930040052279346182' - avatar: >- https://echosell-images.tos-ap-southeast-1.volces.com/user-avatar/92/MS4wLjABAAAARbAbXQxL5Y226gRq9oF3-gC6noCYK4mBquMHk55r9Jxje5JytDImFa2P-r4yV7ro.jpeg category: Shopping & Retail cover_url: '' create_time: 1758722663 duration: 24467 finish_time: 1758747130 followers_growth_rate: 0.0007306487756148924 gpm: 268.165 ifl_most_category_product: >- [{ "category_name":"Beauty & Personal Care","category_id":"601450"}] live_sale_top3_product: >- [{ "product_id":"1729965155119305014","rn":2,"product_name":"BASED Ultimate Straight/Wavy Hair Styling Bundle | Texture Powder, Clay, Pomade, Sea Salt | BASED Bodyworks | Premium Non-Toxic","cover_url":"https://echosell-images.tos-ap-southeast-1.volces.com/product-cover/18/1729965155119305014_0.jpeg","total_sale_cnt":100,"total_sale_gmv_amt":4150.00},{ "product_id":"1729965353009058102","rn":3,"product_name":"BASED Bodywash | Anti-inflammatory & Soothing | Zero Endocrine Disruptors | Sulfate, Paraben, Pthalate Free.","cover_url":"https://echosell-images.tos-ap-southeast-1.volces.com/product-cover/243/1729965353009058102_0.jpeg","total_sale_cnt":100,"total_sale_gmv_amt":2275.00},{ "product_id":"1729707172352594230","rn":1,"product_name":"BASED Leave-in Conditioner | Instant Hydration & Anti-Frizz | Simple, Effective, BASED.","cover_url":"https://echosell-images.tos-ap-southeast-1.volces.com/product-cover/948/1729707172352594230_0.jpeg","total_sale_cnt":200,"total_sale_gmv_amt":5050.00}] live_status: 4 live_type: 1 max_views_cnt: 430 nick_name: BASED per_live_sale_30d_cnt: 100 per_live_sale_gmv_30d_amt: 2894.745 product_category_gmv_distribution: '[{ "category_id":"601450","cnt":27919.00}]' product_category_quantity_distribution: '[{ "category_id":"601450","cnt":20}]' region: US room_id: '7553655890868554509' sales_flag: 1 spu_avg_price: 34.319 title: HOT DEALS ON ALL PRODUCTS!! total_active_product_cnt: 15 total_followers_growth_cnt: 846 total_ifl_digg_cnt: 32347288 total_ifl_followers_cnt: 1207233 total_ifl_post_video_cnt: 5956 total_live_30d_cnt: 27 total_live_commerce_30d_cnt: 4 total_product_cnt: 20 total_sale_cnt: 363 total_sale_gmv_amt: 12589.26 total_views_cnt: 46946 unique_id: based user_id: '7153432386608251946' - avatar: >- https://echosell-images.tos-ap-southeast-1.volces.com/user-avatar/230/MS4wLjABAAAArGa17UdF3NmpiiSOYX8yWQn51zceH59L9kBaf5ZhW_j_ghHB-q34eny6a_uRiBsA.jpeg category: Shopping & Retail cover_url: '' create_time: 1758729845 duration: 57469 finish_time: 1758787314 followers_growth_rate: 0.0019057578492736 gpm: 364.817 ifl_most_category_product: '[{ "category_name":"Collectibles","category_id":"951432"}]' live_sale_top3_product: >- [{ "product_id":"1731312857492918280","rn":2,"product_name":"HACIPUPU Gummy Bear Series-Vinyl Plush Pendant Blind Box","cover_url":"https://echosell-images.tos-ap-southeast-1.volces.com/product-cover/115/1731312857492918280_0.jpeg","total_sale_cnt":1300,"total_sale_gmv_amt":113364.00},{ "product_id":"1731051973704257544","rn":1,"product_name":"THE MONSTERS Big into Energy Series-Vinyl Plush Pendant Blind Box","cover_url":"https://echosell-images.tos-ap-southeast-1.volces.com/product-cover/273/1731051973704257544_0.jpeg","total_sale_cnt":1500,"total_sale_gmv_amt":41985.00},{ "product_id":"1731325578340962312","rn":3,"product_name":"THE MONSTERS Big into Energy Series-Vinyl Plush Pendant Blind Box, Whole Set","cover_url":"https://echosell-images.tos-ap-southeast-1.volces.com/product-cover/906/1731325578340962312_0.jpeg","total_sale_cnt":339,"total_sale_gmv_amt":56931.66}] live_status: 4 live_type: 1 max_views_cnt: 2672 nick_name: POP MART US SHOP per_live_sale_30d_cnt: 43 per_live_sale_gmv_30d_amt: 3082.44591 product_category_gmv_distribution: >- [{ "category_id":"600001","cnt":341.84},{ "category_id":"604206","cnt":331868.29},{ "category_id":"0","cnt":0.00},{ "category_id":"951432","cnt":53208.27}] product_category_quantity_distribution: >- [{ "category_id":"951432","cnt":35},{ "category_id":"604206","cnt":74},{ "category_id":"600001","cnt":1},{ "category_id":"0","cnt":1}] region: US room_id: '7553686785256196919' sales_flag: 1 spu_avg_price: 97.18018 title: New Launch Day! total_active_product_cnt: 72 total_followers_growth_cnt: 1611 total_ifl_digg_cnt: 4802275 total_ifl_followers_cnt: 855550 total_ifl_post_video_cnt: 1122 total_live_30d_cnt: 29 total_live_commerce_30d_cnt: 9 total_product_cnt: 111 total_sale_cnt: 1389 total_sale_gmv_amt: 108465.45 total_views_cnt: 297315 unique_id: popmart.usshop user_id: '7288986759428588590' requestId: 00560d0a-04b5-41a8-ab08-aaee3c1329ac headers: {} '400': description: Bad Request content: application/json: schema: type: object example: code: 400 data: null message: Missing required parameter '401': description: Unauthorized content: application/json: schema: type: object example: code: 401 data: null message: apiKey is null '402': description: Payment Required content: application/json: schema: type: object example: code: 402 data: null message: apiKey quota is not enough '429': description: Too Many Requests content: application/json: schema: type: object example: code: 429 data: null message: qps limit exceeded '500': description: Internal Server Error content: application/json: schema: type: object example: code: 500 data: null message: Internal server error deprecated: false security: - JWT Bearer: [] x-codeSamples: - lang: curl label: cURL source: |- curl --request GET \ --url 'https://api.keyapi.ai/v1/tiktok/live/list/analytics?region=US&page_num=1&page_size=10&user_id=&unique_id=' \ --header 'Authorization: Bearer ' - lang: python label: Python source: |- import requests response = requests.get( 'https://api.keyapi.ai/v1/tiktok/live/list/analytics', params={"region": "US", "page_num": 1, "page_size": 10, "user_id": "", "unique_id": ""}, headers={'Authorization': 'Bearer '} ) print(response.json()) - lang: javascript label: JavaScript source: >- const params = new URLSearchParams({"region": "US", "page_num": 1, "page_size": 10, "user_id": "", "unique_id": ""}); const response = await fetch(`https://api.keyapi.ai/v1/tiktok/live/list/analytics?${params}`, { method: 'GET', headers: { 'Authorization': 'Bearer ' } }); const data = await response.json(); console.log(data); components: securitySchemes: JWT Bearer: type: http scheme: bearer bearerFormat: JWT description: |- API key for authentication. Format: `sk_live_xxxxxxxxxxxxx` Get your API key from the [Dashboard](http://keyapi.ai/app/dashboard). ````