# Video rank list

The video rank list data and the return value of the interface are all incremental data during the list period.

Endpoint: GET /video/ranklist
Version: 1.0.0
Security: MuseumPlaceholderAuth

## Query parameters:

  - `date` (string, required)
    yyyy-MM-dd
    Example: "2024-12-15"

  - `region` (string, required)
    region code
    Example: "US/ID/TH/PH/MY/VN/GB/MX/SG/SA/BR/ES"

  - `influencer_category_name` (string)
    category name
    Example: "Public Figure、Entertainment、Beauty、Personal Blog、Art、Music/Dance、Fashion、Media、Sports、Pets、Education、Baby、Food、Clothing、Gaming、Home、Shopping、Outdoor、Brand、Health、Auto、Tech、Electron、Movie、Life、Travel、Finance、Government、Service"

  - `product_category_id` (string)
    category id

  - `rank_type` (integer, required)
    rank cycle,1=day 2=week 3=month

  - `video_rank_field` (integer, required)
    榜单排序字段 1=total_views_cnt 2=total_video_sale_cnt

  - `page_num` (integer, required)
    page number

  - `page_size` (integer, required)
    page size

## Response 200 fields (application/json):

  - `video_id` (string)
    Example: "7411774681277123841"

  - `user_id` (string)
    Example: "6687120403507250178"

  - `unique_id` (string)
    Example: "ibacksofficial"

  - `nick_name` (string)
    Example: "Ibacks Official"

  - `avatar` (string)
    Example: "https://echosell-images.tos-ap-southeast-1.volces.com/user-avatar/580/MS4wLjABAAAA-6YOxWOUuOYz3ttZaKEYsi7XnHWgQFh_Xdmr4Z30TdwyDbILdxTEZIw2tgXq8ldQ.jpeg"

  - `video_products` (array)
    product ids
    Example: [1729395246927940600,1729395247005600800]

  - `sales_flag` (integer)
    Example: 1

  - `category` (string)
    Example: "Brand"

  - `product_category_list` (array)
    Example: [{"category_name":"Home Supplies","category_id":"600001"}]

  - `video_desc` (string)
    Example: "Place your bath mat like a BOSS! #fyp #likeaboss #bathmat #bathrug"

  - `create_time` (string)
    Example: "1726715400"

  - `reflow_cover` (string)
    Example: "https://echosell-images.tos-ap-southeast-1.volces.com/video-cover/264/7414358686434381063.heic"

  - `region` (string)
    Example: "ID"

  - `duration` (string)
    Example: "7"

  - `total_digg_cnt` (integer)
    Example: 1

  - `total_views_cnt` (integer)
    Example: 1

  - `total_comments_cnt` (integer)
    Example: 1

  - `total_shares_cnt` (integer)
    Example: 1

  - `total_favorites_cnt` (integer)
    Example: 1

  - `total_video_sale_cnt` (integer)
    Example: 1

  - `total_video_sale_gmv_amt` (number)
    Example: 15.67

## Response 403 fields (application/problem+json):

  - `code` (integer)
    Example: 403

  - `message` (string)
    Example: "Usage Limit Exceeded, Please Contact Administrator to Increase Quota"

## Response 429 fields (application/problem+json):

  - `code` (integer)
    Example: 429

  - `message` (string)
    Example: "speed limit"

## Response 500 fields (application/problem+json):

  - `code` (integer)
    Example: 500

  - `message` (string)
    Example: "inner error"

## Response 504 fields (application/problem+json):

  - `code` (integer)
    Example: 504

  - `message` (string)
    Example: "timeout"