# Influencer Video List - EchoTik

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /api/v3/echotik/influencer/video/list:
    get:
      summary: Influencer Video List - EchoTik
      deprecated: false
      description: >
        **API Overview**

        This endpoint returns a creator's historical video list and supports
        filtering or sorting around content and product-video performance. The
        response combines video metadata with views, engagement, video sales,
        and video GMV signals, so it is especially useful when you want to
        understand what kind of content a creator publishes and which videos
        convert.


        **Recommended Use Cases**

        - Review a creator's content style and posting behavior

        - Identify a creator's best-performing commerce videos

        - Analyze how a specific product performed in a creator's video content

        - Support creative benchmarking before influencer outreach


        **Notes**

        - If returned cover, avatar, or image URLs cannot be accessed directly,
        you may need to use EchoTik's image download/conversion workflow

        - Data comes from EchoTik's offline database, so there can be a delay;
        if the API returns no data, it usually means the entity has not been
        collected by EchoTik yet
      tags:
        - Influencer
      parameters:
        - name: user_id
          in: query
          description: ''
          required: false
          schema:
            type: string
        - name: unique_id
          in: query
          description: ''
          required: false
          schema:
            type: string
        - name: product_id
          in: query
          description: Filter by Product ID
          required: false
          schema:
            type: string
        - name: influencer_video_sort_field
          in: query
          description: >-
            Video list sorting field 1=total_views_cnt 2=total_video_sale_cnt
            3=total_video_sale_gmv_amt 4=create_time
          required: false
          schema:
            type: integer
        - name: sort_type
          in: query
          description: Sort order, 0=asc 1=desc
          required: false
          schema:
            type: integer
        - name: page_num
          in: query
          description: Page numbers start from 1 and go up to a maximum of 100,000.
          required: true
          schema:
            type: integer
        - name: page_size
          in: query
          description: The maximum number of pages is 10.
          required: true
          schema:
            type: integer
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: integer
                  message:
                    type: string
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        create_time:
                          type: string
                        created_by_ai:
                          type: string
                        data_size:
                          type: string
                        duration:
                          type: integer
                        height:
                          type: string
                        ratio:
                          type: string
                        reflow_cover:
                          type: string
                          title: >-
                            Cover image URL; if you do not have permission to
                            request it, please use the download API.
                        region:
                          type: string
                        sales_flag:
                          type: integer
                          title: >-
                            Whether to sell goods, sold goods = 1, non-sold
                            goods = 0
                        total_comments_cnt:
                          type: integer
                        total_digg_1d_cnt:
                          type: integer
                          title: Likes increase in the past 1 day
                        total_digg_30d_cnt:
                          type: integer
                          title: Likes increase in the past 30 day
                        total_digg_7d_cnt:
                          type: integer
                          title: Likes increase in the past 7 day
                        total_digg_cnt:
                          type: integer
                        total_favorites_cnt:
                          type: integer
                        total_shares_cnt:
                          type: integer
                        total_video_sale_cnt:
                          type: integer
                          title: Total video sales (estimated)
                        total_video_sale_gmv_amt:
                          type: integer
                          title: Total video sales GMV (estimated)
                        total_views_1d_cnt:
                          type: integer
                          title: Increment in playback volume over the past 1 day
                        total_views_30d_cnt:
                          type: integer
                          title: Increment in playback volume over the past 30 day
                        total_views_7d_cnt:
                          type: integer
                          title: Increment in playback volume over the past 7 day
                        total_views_cnt:
                          type: integer
                        unique_id:
                          type: string
                        user_id:
                          type: string
                        video_desc:
                          type: string
                        video_id:
                          type: string
                        width:
                          type: string
                      x-apifox-orders:
                        - create_time
                        - created_by_ai
                        - data_size
                        - duration
                        - height
                        - ratio
                        - reflow_cover
                        - region
                        - sales_flag
                        - total_comments_cnt
                        - total_digg_1d_cnt
                        - total_digg_30d_cnt
                        - total_digg_7d_cnt
                        - total_digg_cnt
                        - total_favorites_cnt
                        - total_shares_cnt
                        - total_video_sale_cnt
                        - total_video_sale_gmv_amt
                        - total_views_1d_cnt
                        - total_views_30d_cnt
                        - total_views_7d_cnt
                        - total_views_cnt
                        - unique_id
                        - user_id
                        - video_desc
                        - video_id
                        - width
                  requestId:
                    type: string
                x-apifox-orders:
                  - code
                  - message
                  - data
                  - requestId
                x-apifox-refs: {}
                required:
                  - code
                  - message
                  - data
                  - requestId
              example:
                code: 0
                message: success
                data:
                  - create_time: '1779728612'
                    created_by_ai: 'false'
                    data_size: '2595127'
                    duration: 29
                    height: '1280'
                    is_ad: 0
                    ratio: 720p
                    reflow_cover: >-
                      https://echosell-images.tos-ap-southeast-1.volces.com/video-cover/830/7643876071212944654.jpg
                    region: US
                    sales_flag: 1
                    total_comments_cnt: 32
                    total_digg_1d_cnt: 877
                    total_digg_30d_cnt: 877
                    total_digg_7d_cnt: 877
                    total_digg_cnt: 877
                    total_favorites_cnt: 48
                    total_shares_cnt: 22
                    total_video_sale_cnt: 0
                    total_video_sale_gmv_amt: 0
                    total_views_1d_cnt: 31640
                    total_views_30d_cnt: 31640
                    total_views_7d_cnt: 31640
                    total_views_cnt: 31640
                    unique_id: victoriassecret
                    user_id: '6761507140245292038'
                    video_desc: >-
                      Falls down? Uncomfortable? Not for you? The *new*
                      Invisible by VS Bandeau Strapless Bra fixes that.
                      #victoriassecret #summerlooks 
                    video_id: '7643876071212944654'
                    video_products: '[1732322694475518433]'
                    width: '720'
                requestId: 1c3a14cd-ff12-4df4-b3ac-66084c4cca33
          headers: {}
          x-apifox-name: 成功
      security:
        - basic: []
      x-apifox-folder: Influencer
      x-apifox-status: released
      x-run-in-apifox: https://app.apifox.com/web/project/7319100/apis/api-368754151-run
components:
  schemas: {}
  securitySchemes:
    basic:
      type: http
      scheme: basic
servers:
  - url: ''
    description: 正式环境
security: []

```
