Agencia - Lista de creadores

Introducción

Obtén los creadores de TikTok asociados a una agencia, con las siguientes funciones:

• Filtro por ID de agencia
• Ordenación personalizada de resultados
• Incluye datos de ventas del creador y productos más vendidos

Punto de acceso de la API

    POST /agency/v1/creatorList

Cuerpo de la solicitud

Campo	Tipo	Obligatorio	Descripción
filter	object	Sí	Parámetros de filtro
orderby	object	Sí	Parámetros de ordenación
page	integer	No	Número de página, valor predeterminado: 1
pagesize	integer	No	Registros por página, predeterminado: 10, máximo: 100

Valores de filter

Campo	Tipo	Obligatorio	Descripción
id	string	Sí	Secid de la agencia

Valores de orderby

Campo	Tipo	Obligatorio	Descripción
field	string	Sí	Campo de ordenación
order	string	Sí	Orden de clasificación: desc

Campos de ordenación admitidos:

Campo	Descripción
day7_units_sold	Unidades vendidas en los últimos 7 días
day28_units_sold	Unidades vendidas en los últimos 28 días
day90_units_sold	Unidades vendidas en los últimos 90 días
day7_gmv	GMV en los últimos 7 días
day28_gmv	GMV en los últimos 28 días
day90_gmv	GMV en los últimos 90 días
follower_count	Número de seguidores del creador

Solicitud Ejemplo

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

Cuerpo de la respuesta

data

Campo	Tipo	Descripción
list	array<object>	Lista de creadores
total	integer	Recuento total

data.list

Campo	Tipo	Descripción
author	object	Información del creador
day7_units_sold	integer	Unidades vendidas en los últimos 7 días
day28_units_sold	integer	Unidades vendidas en los últimos 28 días
day90_units_sold	integer	Unidades vendidas en los últimos 90 días
day7_gmv	integer	GMV en los últimos 7 días (centavos)
day28_gmv	integer	GMV en los últimos 28 días (centavos)
day90_gmv	integer	GMV en los últimos 90 días (centavos)
live_gpm	string	Rango de GPM en directo
video_gpm	string	Rango de GPM por vídeo
day7_top2_products	array<object>	Los 2 productos principales por unidades en los últimos 7 días
day28_top2_products	array<object>	Los 2 productos principales por unidades en los últimos 28 días
day90_top2_products	array<object>	Los 2 productos principales por unidades en los últimos 90 días

data.list.author

Campo	Tipo	Descripción
uid	string	UID del creador
unique_id	string	ID único del creador
nickname	string	Apodo del creador
avatar	string	URL del avatar del creador
category_id	integer	ID de categoría del creador
category_name	string	Nombre de categoría del creador
follower_count	integer	Número de seguidores
aweme_count	integer	Número total de vídeos
favoriting_count	integer	Total de me gusta recibidos
region	string	Región del creador

data.list.dayX_top2_products

Campo	Tipo	Descripción
product_id	string	ID de producto
sold_count	integer	Unidades vendidas
rank	integer	Posición de ventas (1 o 2)
cover	string	URL de la imagen de portada del producto

Respuesta Ejemplo

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