Búsqueda de creadores

Introducción

Obtén información de creadores por palabras clave o condiciones de filtrado, con las siguientes funciones:

• Admite búsqueda aproximada
• Admite parámetros de filtrado
• Admite ordenación personalizada de resultados

Punto de acceso de la API

POST /creator/v1/search

Cuerpo de la solicitud

Campo	Tipo	Obligatorio	Descripción
keywords	string	No	Palabras clave de búsqueda
filter	object	No	Parámetros de filtro
orderby	object	No	Parámetros de ordenación
page	integer	No	Número de página, predeterminado: 1
pagesize	integer	No	Elementos por página, predeterminado: 10

page * pagesize <= 5000

pagesize Rango: [1, 100]

Detalles de keywords

Longitud máxima de keywords: 140 caracteres

filter Valores opcionales

Campo	Tipo	Obligatorio	Descripción
region	string	No	País/Región
category_id	integer	No	Categoría del creador
verify_type	integer	No	Tipo de verificación: 1 (Normal), 2 (Blue V)
creator_type	integer	No	Tipo de cuenta: 1 (Personal), 2 (Tienda)
follower_gender_type	integer	No	Tipo de género de los seguidores
follower_age_type	integer	No	Tipo de edad de los seguidores
follower_range	object	No	Rango de seguidores
is_mcn_creator	boolean	No	Indica si el creador está afiliado a una MCN/agencia
is_ecommerce_creator	boolean	No	Indica si el creador es un creador de comercio electrónico

Rango de region: ['US','GB','MX','ES','DE','IT','FR','PT','NL','BE','AT','PL','ID','VN','MY','TH','PH','BR','JP','SG']

Rango de follower_age_type: [1,2,3] (1 (18-24 dominante), 2 (25-34 dominante), 3 (35+ dominante))

Rango de follower_gender_type: [0,1] (1 (mayoría hombres), 0 (mayoría mujeres))

orderby Valores opcionales

Campo	Obligatorio	Descripción
follower_count	No	Número de seguidores (desc)
day28_follower_count	No	Crecimiento de seguidores en 28 días (desc)
video_count	No	Número total de vídeos (desc)
video_avg_play_count	No	Reproducciones promedio por vídeo (desc)
video_avg_digg_count	No	Me gusta promedio por vídeo (desc)
day28_units_sold	No	Unidades vendidas en 28 días (desc)

Solicitud Ejemplo

curl 'https://openapi.fastmoss.com/creator/v1/search' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer xxxxxxxxxx' \
--data '{
    "keywords": "daisycabral_",
    "filter": {
        "region": "US",
        follower_range: {
            "min": 1000,
            "max": 10000
        },
        "category_id": 1,
    },
    "orderby": [
      {
        "field": "follower_count",
        "order": "desc",
      }
    ],
    "page": 1,
    "pagesize": 10
}'

Cuerpo de la respuesta

data.total

• Tipo: integer
• Descripción: Número total de resultados

data.list

Campo	Tipo	Descripción
day28_follower_count	integer	Crecimiento de seguidores en 28 días
day28_units_sold	integer	Unidades vendidas en 28 días
day28_gmv	float	GMV en 28 días
total_units_sold	integer	Unidades vendidas en total
total_gmv	float	GMV total
video_count	integer	Número total de vídeos
video_avg_play_count	integer	Reproducciones promedio por vídeo
video_avg_digg_count	integer	Me gusta promedio por vídeo
video_units_sold	integer	Unidades vendidas por vídeo
video_gmv	float	GMV por vídeo
live_count	integer	Transmisiones en directo
live_units_sold	integer	Unidades vendidas en directo
live_gmv	float	GMV en directo
day28_live_count	integer	Número de directos en 28 días
day28_live_gmv	float	GMV en directo en 28 días
currency	string	Moneda
engagement_rate	integer	Tasa de interacción
trend_category	array[object]	Categorías de tendencia de ventas
product_category_l1	array[integer]	Categoría de producto nivel 1
product_category_l2	array[integer]	Categoría de producto nivel 2
product_category_l3	array[integer]	Categoría de producto nivel 3

data.list.creator

Campo	Tipo	Descripción
uid	string	ID de creador
nickname	string	Apodo del creador
unique_id	string	ID único del creador @xxxxxxx
avatar	string	URL del avatar del creador
region	string	Región del creador
seller_id	string	ID de la tienda asociada
follower_count	integer	Número de seguidores del creador
category	array[object]	Categorías del creador
follower_ages	array[object]	Distribución de edad de los seguidores
follower_genders	array[object]	Distribución de género de los seguidores
verify_type	integer	Tipo de verificación

Respuesta Ejemplo

{
  "code": 0,
  "data": {
    "list": [
      {
        "creator": {
          "uid": "7153432386608251946",
          "nickname": "BASED",
          "unique_id": "based",
          "avatar": "https://s.500fd.com/tt_author/55014e26dbf474c4a27a302cea499131~tplv-tiktokx-cropcenter:720:720.jpeg",
          "region": "US",
          "seller_id": "7495079418085345590",
          "verify_type": 2,
          "follower_count": 3030207,
          "category": {
            "id": 2,
            "name": "Shopping & Retail"
          },
          "follower_ages": [
            {
              "key": "18-24",
              "value": "0.3573"
            },
            {
              "key": "25-34",
              "value": "0.2183"
            },
            {
              "key": "35-44",
              "value": "0.1735"
            },
            {
              "key": "13-17",
              "value": "0.1111"
            },
            {
              "key": "45-54",
              "value": "0.0870"
            }
          ],
          "follower_genders": [
            {
              "key": "male",
              "value": "0.9165"
            },
            {
              "key": "female",
              "value": "0.0835"
            }
          ]
        },
        "day28_follower_count": 193164,
        "day28_units_sold": 138827,
        "day28_gmv": 4647070.38,
        "total_units_sold": 986220,
        "total_gmv": 28172233.05,
        "video_count": 374,
        "day28_video_count": 427,
        "video_avg_play_count": 388170,
        "video_avg_digg_count": 7448,
        "video_units_sold": 273894,
        "video_gmv": 7838766.02,
        "live_count": 286,
        "live_units_sold": 708690,
        "live_gmv": 20202277.42,
        "day28_live_count": 41,
        "day28_live_gmv": 4252160,
        "currency": "USD",
        "engagement_rate": 191,
        "trend_category": [
          {
            "id": 1007,
            "name": "Personal Care & Health "
          },
          {
            "id": 1001,
            "name": "Beauty"
          }
        ],
        "product_category_l1": [14],
        "product_category_l2": [848904, 848776, 849160, 849288],
        "product_category_l3": [
          601615, 601469, 601498, 601490, 601619, 981512, 601611, 601646,
          851984, 806160, 1004168, 601681, 601492, 601513
        ]
      }
    ],
    "total": 2000
  },
  "message": "",
  "timestamp": 1776254922,
  "request_id": "198c9aad-b4b5-6d7f-1341-fdafc4bec51a"
}