# Influencer rank list

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

Endpoint: GET /influencer/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"

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

  - `influencer_rank_field` (integer, required)
    rank field. 1=total_followers_cnt 2=total_sale_cnt

  - `page_num` (integer, required)
    page number

  - `page_size` (integer, required)
    page size

## Response 200 fields (application/json):

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

  - `nick_name` (string)
    Example: "prodbypocholo"

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

  - `avatar` (string)
    Example: "https://echosell-images.tos-ap-southeast-1.volces.com/user-avatar/555/MS4wLjABAAAAxcHrUHu3Vp6ioPm3bUHEnusPvstKH7VkNIwR6Etks8a5QA3hWgVMHmuueARO_S-A.jpeg"

  - `category` (string)
    Example: "Media & Entertainment"

  - `ec_score` (number)
    Example: 4.5

  - `total_followers_cnt` (integer)
    Example: 1

  - `total_digg_cnt` (integer)
    Example: 1

  - `total_live_cnt` (integer)
    Example: 1

  - `total_post_video_cnt` (integer)
    Example: 1

  - `total_product_cnt` (integer)
    Example: 1

  - `total_sale_cnt` (integer)
    Example: 1

  - `total_sale_gmv_amt` (number)
    Example: 15.67

  - `sales_flag` (integer)
    Main Sales Methods
    Example: 1

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