> ## 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.

# 直播列表-EchoTik

> 这是离线直播检索接口，支持按地区、达人ID、达人 `unique_id`、直播类型、直播状态、是否带货、开播时间范围、达人分类、排序字段、销量、时长、观看人次等条件筛选。返回非常偏经营分析，既有直播间封面、标题、开播/结束时间、时长、在线峰值、观看人次、动销商品数、总销量、总GMV，也有达人头像、分类、近30天直播销量/GMV、粉丝数和视频数等账号信息。

**接口用途推荐**
- 适合批量找高表现直播间
- 筛某个市场最近强势直播
- 区分店铺播和个人播
- 找非带货直播或带货直播样本、看不同达人分类的直播表现，也适合直播情报监控

**注意事项**
- 数据出自EchoTik，所以该数据均属于离线数据，会有延迟，如果接口返回没有数据证明EchoTik并未收录该数据

<div className="inline-flex items-center gap-2 px-4 py-2 bg-yellow-50 dark:bg-yellow-900/20 border border-yellow-200 dark:border-yellow-800 rounded-lg">
  <span className="text-base">🪙</span>
  <span className="text-sm font-medium text-yellow-900 dark:text-yellow-100"><span className="font-semibold">1 credit</span><span className="text-yellow-700 dark:text-yellow-300 ml-1">每次请求</span></span>
</div>

## Copy for AI

<div className="my-6 rounded-xl border border-gray-200 bg-gray-50 p-5 dark:border-gray-800 dark:bg-gray-900/40">
  <div className="min-w-0">
    <p className="text-base font-semibold text-gray-900 dark:text-gray-100">🤖 让 AI 帮你写调用代码</p>
    <p className="mt-1 text-sm text-gray-700 dark:text-gray-300">点击按钮复制一段结构化提示词，可直接交给 ChatGPT、Claude 或其他 AI 助手生成接口调用代码。</p>
  </div>

  <div className="mt-4">
    <button type="button" className="inline-flex items-center gap-2 rounded-md border border-emerald-300 bg-emerald-50 px-3 py-2 text-sm font-medium text-emerald-800 hover:bg-emerald-100 dark:border-emerald-700 dark:bg-emerald-900/30 dark:text-emerald-100 dark:hover:bg-emerald-900/50" onClick={() => navigator.clipboard.writeText("我想调用 KeyAPI 接口：GET https://api.keyapi.ai/v1/tiktok/live/list/analytics\n\n请帮我编写调用代码，并包含必要的错误处理、参数校验和响应处理逻辑。\n\n接口信息：\n\nEndpoint: GET https://api.keyapi.ai/v1/tiktok/live/list/analytics\n\nDescription: 这是离线直播检索接口，支持按地区、达人ID、达人 `unique_id`、直播类型、直播状态、是否带货、开播时间范围、达人分类、排序字段、销量、时长、观看人次等条件筛选。返回非常偏经营分析，既有直播间封面、标题、开播/结束时间、时长、在线峰值、观看人次、动销商品数、总销量、总GMV，也有达人头像、分类、近30天直播销量/GMV、粉丝数和视频数等账号信息。\n\n**接口用途推荐**\n- 适合批量找高表现直播间\n- 筛某个市场最近强势直播\n- 区分店铺播和个人播\n- 找非带货直播或带货直播样本、看不同达人分类的直播表现，也适合直播情报监控\n\n**注意事项**\n- 数据出自EchoTik，所以该数据均属于离线数据，会有延迟，如果接口返回没有数据证明EchoTik并未收录该数据\n\nRequired Headers:\n--header 'Authorization: Bearer <YOUR_API_KEY>'\n\nParameters:\n- region (Required): 区域代码，地区，例如US. Example: US\n- page_num (Required): 分页页码，从1开始，最大100000. Example: 1\n- page_size (Required): 分页页数，最大等于10. Example: 10\n- user_id (Optional): 达人ID筛选. Example: \n- unique_id (Optional): 达人ID筛选. Example: \n- live_type (Optional): 直播类型， 1=店铺播 2=个人播. Example: \n- live_status (Optional): 直播状态，2=进行中，4=已结束. Example: \n- sales_flag (Optional): 是否带货， 0=非带货 1=带货. Example: \n- min_create_time (Optional): 直播创建时间筛选. Example: \n- max_create_time (Optional): 直播创建时间筛选. Example: \n- category (Optional): 达人分类筛选. Example: \n- live_sort_field (Optional): 列表排序字段，1=create_time， 2=total_sale_cnt， 3=total_user_cnt，4=max_user_count_cnt. Example: \n- sort_type (Optional): 排序顺序，排序顺序 0=asc 1=desc. Example: \n- min_total_sale_cnt (Optional): 直播销量筛选. Example: \n- max_total_sale_cnt (Optional): 直播销量筛选. Example: \n- min_duration (Optional): 直播时长筛选. Example: \n- max_duration (Optional): 直播时长筛选. Example: \n- min_total_views_cnt (Optional): 直播观看人次筛选. Example: \n- max_total_views_cnt (Optional): 直播观看人次筛选. Example: \n\nExample Response:\n{\n  \"code\": 0,\n  \"message\": \"success\",\n  \"data\": [\n    {\n      \"avatar\": \"https://echosell-images.tos-ap-southeast-1.volces.com/user-avatar/92/MS4wLjABAAAARbAbXQxL5Y226gRq9oF3-gC6noCYK4mBquMHk55r9Jxje5JytDImFa2P-r4yV7ro.jpeg\",\n      \"category\": \"Shopping & Retail\",\n      \"cover_url\": \"\",\n      \"create_time\": 1758476363,\n      \"duration\": 84090,\n      \"finish_time\": 1758560453,\n      \"followers_growth_rate\": 0.003482208132624495,\n      \"gpm\": 0,\n      \"ifl_most_category_product\": \"[{ \\\"category_name\\\":\\\"Beauty & Personal Care\\\",\\\"category_id\\\":\\\"601450\\\"}]\",\n      \"live_sale_top3_product\": \"[]\",\n      \"live_status\": 4,\n      \"live_type\": 1,\n      \"max_views_cnt\": 924,\n      \"nick_name\": \"Based Bodyworks\",\n      \"per_live_sale_30d_cnt\": 100,\n      \"per_live_sale_gmv_30d_amt\": 2894.745,\n      \"product_category_gmv_distribution\": \"[]\",\n      \"product_category_quantity_distribution\": \"[]\",\n      \"region\": \"US\",\n      \"room_id\": \"7552598204001405710\",\n      \"sales_flag\": 0,\n      \"spu_avg_price\": 0,\n      \"title\": \"HOT DEALS ON ALL PRODUCTS!!\",\n      \"total_active_product_cnt\": 0,\n      \"total_followers_growth_cnt\": 4101,\n      \"total_ifl_digg_cnt\": 31987286,\n      \"total_ifl_followers_cnt\": 1198818,\n      \"total_ifl_post_video_cnt\": 5937,\n      \"total_live_30d_cnt\": 27,\n      \"total_live_commerce_30d_cnt\": 4,\n      \"total_product_cnt\": 0,\n      \"total_sale_cnt\": 0,\n      \"total_sale_gmv_amt\": 0,\n      \"total_views_cnt\": 281956,\n      \"unique_id\": \"based\",\n      \"user_id\": \"7153432386608251946\"\n    },\n    {\n      \"avatar\": \"https://echosell-images.tos-ap-southeast-1.volces.com/user-avatar/959/MS4wLjABAAAATZQ4SyFsdzAFGEUEqnRTGKUdwhgKIEbuNgNFi6R8UqdqNOTBi50mUMPh9RAQPbl8.jpeg\",\n      \"category\": \"Other\",\n      \"cover_url\": \"\",\n      \"create_time\": 1758500543,\n      \"duration\": 289253,\n      \"finish_time\": 1758789796,\n      \"followers_growth_rate\": 0.0010308853243165231,\n      \"gpm\": 0,\n      \"ifl_most_category_product\": \"[{ \\\"category_name\\\":\\\"Kitchenware\\\",\\\"category_id\\\":\\\"600024\\\"}]\",\n      \"live_sale_top3_product\": \"[]\",\n      \"live_status\": 4,\n      \"live_type\": 2,\n      \"max_views_cnt\": 230,\n      \"nick_name\": \"niknikspeaks48\",\n      \"per_live_sale_30d_cnt\": 0,\n      \"per_live_sale_gmv_30d_amt\": 0,\n      \"product_category_gmv_distribution\": \"[]\",\n      \"product_category_quantity_distribution\": \"[]\",\n      \"region\": \"US\",\n      \"room_id\": \"7552702288578677535\",\n      \"sales_flag\": 0,\n      \"spu_avg_price\": 0,\n      \"title\": \"\",\n      \"total_active_product_cnt\": 0,\n      \"total_followers_growth_cnt\": 88,\n      \"total_ifl_digg_cnt\": 897029,\n      \"total_ifl_fo\n  ... truncated ...\n\n请根据以上信息给出可直接运行的示例代码。")}>
      ✨ 复制给 AI
    </button>
  </div>
</div>


## OpenAPI

````yaml zh/tiktok.zh.openapi.json GET /v1/tiktok/live/list/analytics
openapi: 3.0.1
info:
  title: Tiktok API 中文文档
  description: Tiktok API 的中文参考文档，包含接口用途、参数说明、响应状态和示例结构。
  version: 1.0.0
servers:
  - url: https://api.keyapi.ai
    description: Production
security: []
tags:
  - name: TikTok 达人
  - name: TikTok 店铺
  - name: TikTok 内容数据
  - name: TikTok 趋势洞察
paths:
  /v1/tiktok/live/list/analytics:
    get:
      tags:
        - TikTok 内容数据
      summary: 直播列表-EchoTik
      description: >-
        这是离线直播检索接口，支持按地区、达人ID、达人
        `unique_id`、直播类型、直播状态、是否带货、开播时间范围、达人分类、排序字段、销量、时长、观看人次等条件筛选。返回非常偏经营分析，既有直播间封面、标题、开播/结束时间、时长、在线峰值、观看人次、动销商品数、总销量、总GMV，也有达人头像、分类、近30天直播销量/GMV、粉丝数和视频数等账号信息。


        **接口用途推荐**

        - 适合批量找高表现直播间

        - 筛某个市场最近强势直播

        - 区分店铺播和个人播

        - 找非带货直播或带货直播样本、看不同达人分类的直播表现，也适合直播情报监控


        **注意事项**

        - 数据出自EchoTik，所以该数据均属于离线数据，会有延迟，如果接口返回没有数据证明EchoTik并未收录该数据
      parameters:
        - name: region
          in: query
          description: 区域代码，地区，例如US
          required: true
          example: US
          schema:
            type: string
            example: US
        - name: page_num
          in: query
          description: 分页页码，从1开始，最大100000
          required: true
          example: 1
          schema:
            type: integer
            example: 1
        - name: page_size
          in: query
          description: 分页页数，最大等于10
          required: true
          example: 10
          schema:
            type: integer
            example: 10
        - name: user_id
          in: query
          description: 达人ID筛选
          required: false
          example: ''
          schema:
            type: string
            example: ''
        - name: unique_id
          in: query
          description: 达人ID筛选
          required: false
          example: ''
          schema:
            type: string
            example: ''
        - name: live_type
          in: query
          description: 直播类型， 1=店铺播 2=个人播
          required: false
          example: ''
          schema:
            type: integer
            example: ''
        - name: live_status
          in: query
          description: 直播状态，2=进行中，4=已结束
          required: false
          example: ''
          schema:
            type: integer
            example: ''
        - name: sales_flag
          in: query
          description: 是否带货， 0=非带货 1=带货
          required: false
          example: ''
          schema:
            type: integer
            example: ''
        - name: min_create_time
          in: query
          description: 直播创建时间筛选
          required: false
          example: ''
          schema:
            type: integer
            example: ''
        - name: max_create_time
          in: query
          description: 直播创建时间筛选
          required: false
          example: ''
          schema:
            type: integer
            example: ''
        - name: category
          in: query
          description: 达人分类筛选
          required: false
          example: ''
          schema:
            type: string
            example: ''
        - name: live_sort_field
          in: query
          description: >-
            列表排序字段，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: 排序顺序，排序顺序 0=asc 1=desc
          required: false
          example: ''
          schema:
            type: integer
            example: ''
        - name: min_total_sale_cnt
          in: query
          description: 直播销量筛选
          required: false
          example: ''
          schema:
            type: integer
            example: ''
        - name: max_total_sale_cnt
          in: query
          description: 直播销量筛选
          required: false
          example: ''
          schema:
            type: integer
            example: ''
        - name: min_duration
          in: query
          description: 直播时长筛选
          required: false
          example: ''
          schema:
            type: integer
            example: ''
        - name: max_duration
          in: query
          description: 直播时长筛选
          required: false
          example: ''
          schema:
            type: integer
            example: ''
        - name: min_total_views_cnt
          in: query
          description: 直播观看人次筛选
          required: false
          example: ''
          schema:
            type: integer
            example: ''
        - name: max_total_views_cnt
          in: query
          description: 直播观看人次筛选
          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: 请求参数错误，请检查必填字段和参数格式
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 400
                  data: null
                  message: Missing required parameter
        '401':
          description: 鉴权失败，请检查 Authorization Header 中的 Bearer Token 或 API Key 是否有效
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 401
                  data: null
                  message: apiKey is null
        '402':
          description: 账户余额或额度不足
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 402
                  data: null
                  message: apiKey quota is not enough
        '429':
          description: 请求过于频繁，已触发限流
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 429
                  data: null
                  message: qps limit exceeded
        '500':
          description: 服务器内部错误，请稍后重试
          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 <YOUR_API_KEY>'
        - 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 <YOUR_API_KEY>'}
            )
            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 <YOUR_API_KEY>' }
            });

            const data = await response.json();

            console.log(data);
components:
  securitySchemes:
    JWT Bearer:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: |-
        接口鉴权凭证。请在请求 Header 中传入 `Authorization: Bearer <YOUR_API_KEY>`。
        可在 [Dashboard](https://keyapi.ai/app/dashboard) 获取你的 API Key。

````