# Seller rank list

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

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

  - `category_id` (string)
    first level category id
    Example: "600001"

  - `category_l2_id` (string)
    second level category id
    Example: "851848"

  - `category_l3_id` (string)
    third level category id
    Example: "600621"

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

  - `seller_rank_field` (integer, required)
    rank field. 1=total_sale_cnt 2=total_ifl_cnt

  - `page_num` (integer, required)
    page number

  - `page_size` (integer, required)
    page size

## Response 200 fields (application/json):

  - `seller_id` (string)
    Example: "7493991011861366211"

  - `seller_name` (string)
    Example: "Illamasqua"

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

  - `rating` (number)
    Example: 3.3

  - `cover_url` (string)
    Example: "https://echosell-images.tos-ap-southeast-1.volces.com/seller-cover/284/7493991011861366211.png"

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

  - `most_product_category_list` (array)
    Example: [{"category_name":"Beauty & Personal Care","category_id":"601450"}]

  - `total_sale_cnt` (integer)
    Example: 10

  - `total_sale_gmv_amt` (number)
    Example: 12.56

  - `total_product_cnt` (integer)
    Example: 10

  - `total_ifl_cnt` (integer)
    Example: 10

  - `total_video_cnt` (integer)
    Example: 10

  - `total_live_cnt` (integer)
    Example: 10

  - `category_id` (string)
    Example: "600001"

  - `category_l2_id` (string)
    Example: "851848"

  - `category_l3_id` (string)
    Example: "600621"

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