Agência - Lista de criadores

Introdução

Obtém os criadores do TikTok associados a uma agência, com os seguintes recursos:

• Filtrar por ID da agência
• Personalizar a ordenação dos resultados
• Inclui dados de vendas dos criadores e produtos mais vendidos

Endpoint da API

    POST /agency/v1/creatorList

Corpo da solicitação

Campo	Tipo	Obrigatório	Descrição
filter	object	Sim	Parâmetros de filtro
orderby	object	Sim	Parâmetros de ordenação
page	integer	Não	Número da página, valor padrão: 1
pagesize	integer	Não	Registros por página, padrão: 10, máximo: 100

Opções de filter

Campo	Tipo	Obrigatório	Descrição
id	string	Sim	secid da agência

Opções de orderby

Campo	Tipo	Obrigatório	Descrição
field	string	Sim	Campo de ordenação
order	string	Sim	Ordem de ordenação: desc

Campos de ordenação suportados:

Campo	Descrição
day7_units_sold	Unidades vendidas nos últimos 7 dias
day28_units_sold	Unidades vendidas nos últimos 28 dias
day90_units_sold	Unidades vendidas nos últimos 90 dias
day7_gmv	GMV nos últimos 7 dias
day28_gmv	GMV nos últimos 28 dias
day90_gmv	GMV nos últimos 90 dias
follower_count	Número de seguidores do criador

Exemplo de solicitação

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

Corpo da resposta

data

Campo	Tipo	Descrição
list	array<object>	Lista de criadores
total	integer	Total

data.list

Campo	Tipo	Descrição
author	object	Informações do criador
day7_units_sold	integer	Unidades vendidas nos últimos 7 dias
day28_units_sold	integer	Unidades vendidas nos últimos 28 dias
day90_units_sold	integer	Unidades vendidas nos últimos 90 dias
day7_gmv	integer	GMV nos últimos 7 dias (centavos)
day28_gmv	integer	GMV nos últimos 28 dias (centavos)
day90_gmv	integer	GMV nos últimos 90 dias (centavos)
live_gpm	string	Intervalo de GPM ao vivo
video_gpm	string	Intervalo de GPM de vídeo
day7_top2_products	array<object>	Top 2 produtos por unidades nos últimos 7 dias
day28_top2_products	array<object>	Top 2 produtos por unidades nos últimos 28 dias
day90_top2_products	array<object>	Top 2 produtos por unidades nos últimos 90 dias

data.list.author

Campo	Tipo	Descrição
uid	string	UID do criador
unique_id	string	ID exclusivo do criador
nickname	string	Apelido do criador
avatar	string	URL do avatar do criador
category_id	integer	ID da categoria do criador
category_name	string	Nome da categoria do criador
follower_count	integer	Número de seguidores
aweme_count	integer	Número total de vídeos
favoriting_count	integer	Total de curtidas recebidas
region	string	Região do criador

data.list.dayX_top2_products

Campo	Tipo	Descrição
product_id	string	ID do produto
sold_count	integer	Unidades vendidas
rank	integer	Classificação de vendas (1 ou 2)
cover	string	URL da imagem de capa do produto

Exemplo de resposta

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