Đại lý - Danh sách nhà sáng tạo

Giới thiệu

Lấy các nhà sáng tạo TikTok liên kết với một đại lý, hỗ trợ các tính năng sau:

• Lọc theo ID đại lý
• Tùy chỉnh sắp xếp kết quả
• Bao gồm dữ liệu doanh số của nhà sáng tạo và các sản phẩm bán chạy nhất

Endpoint

    POST /agency/v1/creatorList

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

Trường	Kiểu	Bắt buộc	Mô tả
filter	object	Có	Tham số lọc
orderby	object	Có	Tham số sắp xếp
page	integer	Không	Số trang, giá trị mặc định: 1
pagesize	integer	Không	Số bản ghi mỗi trang, mặc định: 10, tối đa: 100

tùy chọn filter

Trường	Kiểu	Bắt buộc	Mô tả
id	string	Có	secid của đại lý

tùy chọn orderby

Trường	Kiểu	Bắt buộc	Mô tả
field	string	Có	Trường sắp xếp
order	string	Có	Thứ tự sắp xếp: desc

Các trường sắp xếp được hỗ trợ:

Trường	Mô tả
day7_units_sold	Số đơn vị bán trong 7 ngày qua
day28_units_sold	Số đơn vị bán trong 28 ngày qua
day90_units_sold	Số đơn vị bán trong 90 ngày qua
day7_gmv	GMV trong 7 ngày qua
day28_gmv	GMV trong 28 ngày qua
day90_gmv	GMV trong 90 ngày qua
follower_count	Số người theo dõi của nhà sáng tạo

Ví dụ yêu cầu

curl 'https://openapi.fastmoss.com/agency/v1/creatorList' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer xxxxxxxxxx' \
--data '{
    "filter": {
        "id": "647f81f2fccde42ac22be7fe7bee2c26"
    },
    "orderby": [
        {
            "field": "day7_gmv",
            "order": "desc"
        }
    ],
    "page": 1,
    "pagesize": 10
}'

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

data

Trường	Kiểu	Mô tả
list	array<object>	Danh sách nhà sáng tạo
total	integer	Tổng số

data.list

Trường	Kiểu	Mô tả
author	object	Thông tin nhà sáng tạo
day7_units_sold	integer	Số đơn vị bán trong 7 ngày qua
day28_units_sold	integer	Số đơn vị bán trong 28 ngày qua
day90_units_sold	integer	Số đơn vị bán trong 90 ngày qua
day7_gmv	integer	GMV trong 7 ngày qua (cent)
day28_gmv	integer	GMV trong 28 ngày qua (cent)
day90_gmv	integer	GMV trong 90 ngày qua (cent)
live_gpm	string	Khoảng GPM phát trực tiếp
video_gpm	string	Khoảng GPM video
day7_top2_products	array<object>	Top 2 sản phẩm theo số đơn vị trong 7 ngày qua
day28_top2_products	array<object>	Top 2 sản phẩm theo số đơn vị trong 28 ngày qua
day90_top2_products	array<object>	Top 2 sản phẩm theo số đơn vị trong 90 ngày qua

data.list.author

Trường	Kiểu	Mô tả
uid	string	UID nhà sáng tạo
unique_id	string	ID duy nhất của 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
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
aweme_count	integer	Tổng số video
favoriting_count	integer	Tổng số lượt thích nhận được
region	string	Khu vực của nhà sáng tạo

data.list.dayX_top2_products

Trường	Kiểu	Mô tả
product_id	string	ID sản phẩm
sold_count	integer	Số đơn vị đã bán
rank	integer	Xếp hạng doanh số (1 hoặc 2)
cover	string	URL ảnh bìa sản phẩm

Ví dụ phản hồi

{
  "code": 0,
  "data": {
    "list": [
      {
        "author": {
          "uid": "7520310673173316621",
          "unique_id": "sophmademebuyit",
          "nickname": "Soph🦋",
          "avatar": "tt_author/e2a93268378892efa5477548c160e19e~tplv-tiktokx-cropcenter:100:100.jpeg",
          "category_id": 31,
          "category_name": "Other",
          "follower_count": 29468,
          "aweme_count": 2042,
          "favoriting_count": 530,
          "region": "US"
        },
        "day7_units_sold": 4955,
        "day28_units_sold": 19952,
        "day90_units_sold": 51672,
        "day7_gmv": 270119,
        "day28_gmv": 1134310,
        "day90_gmv": 2922456,
        "live_gpm": "$0.00 - $0.00",
        "video_gpm": "$39.82 - $44.95",
        "day7_top2_products": [
          {
            "product_id": "1732261201982428094",
            "sold_count": 635,
            "rank": 2,
            "cover": "https://s.500fd.com/tt_product/293d96fb07b2482a89c0191e02072278~tplv-fhlh96nyum-resize-jpeg:800:800.jpeg"
          },
          {
            "product_id": "1731581852072907320",
            "sold_count": 1078,
            "rank": 1,
            "cover": "https://s.500fd.com/tt_product/c7338303f352404a8a89ce2fded825c4~tplv-fhlh96nyum-resize-jpeg:800:800.jpeg"
          }
        ]
      }
    ],
    "total": 1382
  },
  "message": "success"
}