Agensi - Daftar Kreator

Pendahuluan

Dapatkan kreator TikTok yang terkait dengan agensi, mendukung fitur berikut:

• Filter berdasarkan ID agensi
• Sesuaikan pengurutan hasil
• Mencakup data penjualan kreator dan produk terlaris

Endpoint

    POST /agency/v1/creatorList

Isi Permintaan

Bidang	Tipe	Wajib	Deskripsi
filter	object	Ya	Parameter filter
orderby	object	Ya	Parameter pengurutan
page	integer	Tidak	Nomor halaman, nilai default: 1
pagesize	integer	Tidak	Catatan per halaman, default: 10, maks: 100

opsi filter

Bidang	Tipe	Wajib	Deskripsi
id	string	Ya	secid agensi

opsi orderby

Bidang	Tipe	Wajib	Deskripsi
field	string	Ya	Bidang pengurutan
order	string	Ya	Urutan pengurutan: desc

Bidang pengurutan yang didukung:

Bidang	Deskripsi
day7_units_sold	Unit terjual dalam 7 hari terakhir
day28_units_sold	Unit terjual dalam 28 hari terakhir
day90_units_sold	Unit terjual dalam 90 hari terakhir
day7_gmv	GMV dalam 7 hari terakhir
day28_gmv	GMV dalam 28 hari terakhir
day90_gmv	GMV dalam 90 hari terakhir
follower_count	Jumlah pengikut kreator

Contoh Permintaan

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
}'

Isi Respons

data

Bidang	Tipe	Deskripsi
list	array<object>	Daftar kreator
total	integer	Jumlah total

data.list

Bidang	Tipe	Deskripsi
author	object	Informasi kreator
day7_units_sold	integer	Unit terjual dalam 7 hari terakhir
day28_units_sold	integer	Unit terjual dalam 28 hari terakhir
day90_units_sold	integer	Unit terjual dalam 90 hari terakhir
day7_gmv	integer	GMV dalam 7 hari terakhir (sen)
day28_gmv	integer	GMV dalam 28 hari terakhir (sen)
day90_gmv	integer	GMV dalam 90 hari terakhir (sen)
live_gpm	string	Rentang GPM live
video_gpm	string	Rentang GPM video
day7_top2_products	array<object>	2 produk teratas berdasarkan unit dalam 7 hari terakhir
day28_top2_products	array<object>	2 produk teratas berdasarkan unit dalam 28 hari terakhir
day90_top2_products	array<object>	2 produk teratas berdasarkan unit dalam 90 hari terakhir

data.list.author

Bidang	Tipe	Deskripsi
uid	string	UID Kreator
unique_id	string	ID unik kreator
nickname	string	Nama panggilan kreator
avatar	string	URL avatar kreator
category_id	integer	ID kategori kreator
category_name	string	Nama kategori kreator
follower_count	integer	Jumlah pengikut
aweme_count	integer	Total jumlah video
favoriting_count	integer	Total suka yang diterima
region	string	Wilayah kreator

data.list.dayX_top2_products

Bidang	Tipe	Deskripsi
product_id	string	ID Produk
sold_count	integer	Unit terjual
rank	integer	Peringkat penjualan (1 atau 2)
cover	string	URL gambar sampul produk

Contoh Respons

{
  "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"
}