Liên kết cửa hàng

Giới thiệu

Lấy các liên kết quảng bá cửa hàng bằng seller_id.

Endpoint

POST /shop/v1/creatorList

Phần thân yêu cầu

Trường	Kiểu	Bắt buộc	Mô tả
filter	object	Không	Tham số lọc
orderby	object	Không	Tham số sắp xếp
page	integer	Không	Mặc định: 1
pagesize	integer	Không	Mặc định: 10

Giá trị tùy chọn của filter

Trường	Kiểu	Bắt buộc	Mô tả
seller_id	string	Không	ID cửa hàng
creator_uid	string	Không	UID nhà sáng tạo liên kết với cửa hàng
creator_unique_id	string	Không	ID nhà sáng tạo duy nhất liên kết với cửa hàng: @xxxxxxx
seller_name	string	Không	Tên cửa hàng
region	string	Không	Quốc gia/Khu vực của cửa hàng

seller_name và region phải được truyền cùng lúc

Giá trị tùy chọn của orderby

Trường	Bắt buộc	Mô tả
digg_count	Không	số lượt digg
follower_count	Không	số người theo dõi
units_sold	Không	Sản lượng bán
gmv	Không	Số tiền bán (GMV)

Ví dụ yêu cầu

curl 'https://openapi.fastmoss.com/shop/v1/creatorList' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer xxxxxxxxxx' \
--data '{
    "filter": {
        "seller_id": "7495500842223700917",
        # "creator_uid": "xxxxxxxxxxx",
        # "creator_unique_id": "xxxxxxx",
        # "seller_name": "xxxxxx",
        # "region": "US"
    },
    "orderby": [{
        "field": "units_sold",
        "order": "desc"
    }],
    # "orderby": [{
    #     "field": "gmv",
    #     "order": "desc"
    # }],
    # "orderby": [{
    #     "field": "follower_count",
    #     "order": "desc"
    # }],
    # "orderby": [{
    #     "field": "digg_count",
    #     "order": "desc"
    # }],
    "page": 1,
    "pagesize": 10
}'

Phần thân phản hồi

data.total

Tổng số kết quả

data.list

Trường	Kiểu	Mô tả
uid	string	UID nhà sáng tạo
seller_id	string	ID cửa hàng
unique_id	string	ID duy nhất nhà sáng tạo
nickname	string	Biệt danh nhà sáng tạo
avatar	string	URL ảnh đại diện nhà sáng tạo
units_sold	integer	Doanh số của nhà sáng tạo
gmv	float	GMV của nhà sáng tạo
category_id	integer	ID danh mục nhà sáng tạo
category_name	string	Tên danh mục nhà sáng tạo
follower_count	integer	Số người theo dõi của nhà sáng tạo
aweme_count	integer	Số video của nhà sáng tạo
favoriting_count	integer	Số lượt yêu thích của nhà sáng tạo
region	string	Khu vực của nhà sáng tạo

Ví dụ phản hồi

{
  "code": 0,
  "msg": "success",
  "data": {
    "total": 8,
    "list": [
      {
        "uid": "6893103660525831169",
        "seller_id": "xxxxxxxxxxxx",
        "units_sold": 1354,
        "gmv": 22034.60,
        "unique_id": "twobakeboys",
        "nickname": "Twobakeboys",
        "avatar": "https://s.500fd.com/tt_author/935c7d720caecc448ed85fbcbac1218b~c5_300x300.jpeg",
        "category_id": 5, //creator's category_id
        "category_name": "Food & Beverage", //creator's category_name
        "category": [//deprecated
            "Food & Beverage"
        ],
        "follower_count": 22572,
        "aweme_count": 510,
        "favoriting_count": 480,
        "region": "SG" //creator's region
      }
     ]
 }
}