tiktok-creative-center/
creator-cards

Consulte las fichas de TikTok Creator Marketplace de hasta 20 creadores por ID: desglose de seguidores por edad, género, país y dispositivo, mediana de vistas, interacción y tarifa inicial.

TikTok Creator Marketplace API

Hasta 20 creadores
Datos demográficos de la audiencia
Tarifas iniciales
0.5 créditos por resultado
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

TikTok Creator Marketplace

Una ficha de TikTok Creator Marketplace es el perfil que ven las marcas al evaluar a un creador para un trabajo pagado: reúne la biografía y los seguidores del creador con la distribución de sus seguidores por edad, género, país y dispositivo, la mediana de vistas, las tasas de interacción y de crecimiento, y la tarifa inicial que indica para un video patrocinado. Con esas fichas las marcas comparan a los creadores en una sola vista según el ajuste de la audiencia, el rendimiento habitual y el precio.

Funcionalidades de la TikTok Creator Marketplace API

  • Cuatro cortes de audienciaaudience divide a los seguidores por rango de edad, género, país y marca de teléfono, y cada entrada es una proporción de 0 a 1.
  • Referencias de rendimientometrics contiene followers_count, median_views, engagement_rate, followers_growth_rate y six_second_view_rate.
  • Tarifa inicial publicadastarting_price devuelve el monto y la moneda que el creador indica para un video patrocinado, como un número con el que se puede calcular.
  • Hasta 20 creadores por solicitudcreator_ids recibe de 1 a 20 ID de Creator Marketplace y devuelve una ficha por cada creador que tenga una.
  • Identidad en cada fichausername, name, el texto de la biografía, avatar_url, region, tiktok_user_id, url y recent_video_ids vinculan un ID de Marketplace con una cuenta real.

Parámetros de la TikTok Creator Marketplace API

ParámetrosObligatorioDescripción
creator_idsObligatorioDe uno a 20 ID de Creator Marketplace, como los valores de creator_id de los resultados de TikTok Creative Center Top Videos.

Cómo usar la TikTok Creator Marketplace API

Reúna ID de creadores desde Top Videos y luego lea sus fichas.

  1. Ejecute TikTok Creative Center Top Videos y copie el creator_id de los creadores que quiere evaluar.
  2. Envíe {"creator_ids": ["7011198409688219653", "7070293872819044358"]} por POST a /v1/tiktok-creative-center/creator-cards.
  3. Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded y lea una ficha por creador en results.items.
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/creator-cards" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"creator_ids":["7011198409688219653","7070293872819044358"]}'

# audience.ages, genders, countries and devices are shares from 0 to 1.

Casos de uso de la TikTok Creator Marketplace API

  • Filtrar por ajuste de audiencia: Compare audience.ages, genders y countries de una lista corta con el cliente al que quiere llegar y descarte a los creadores cuyos seguidores están en los mercados equivocados.
  • Comparar el costo por vista: Divida starting_price.amount entre median_views para comparar lo que compra la tarifa publicada de cada creador, en lugar de comparar cantidades de seguidores.
  • Clasificar por impulso: Ordene una lista corta por engagement_rate y followers_growth_rate para encontrar creadores que responden bien y que además siguen ganando seguidores.

Consejos de expertos para la TikTok Creator Marketplace API

  • Tome los ID del campo creator_id de las filas de Top Videos; un ID de usuario de TikTok como author.id no corresponde a una ficha y se omite.
  • Trate cada corte de audiencia como una lista de proporciones que pueden sumar un poco menos de 1, y relacione las entradas por su etiqueta y no por su posición.
  • Lea starting_price.amount junto con currency y trátelo como la cifra de partida del creador, ya que las tarifas finales se acuerdan por proyecto.

Además de la TikTok Creator Marketplace API, use estas APIs cuando necesite otro tipo de datos públicos de TikTok Creative Center.

Explorar otras plataformas

Combine los datos de TikTok Creative Center con datos públicos de otras plataformas sociales compatibles.

TikTok Creator Marketplace API — FAQ

TikTok Creator Marketplace API es una interfaz programática para obtener las fichas de TikTok Creator Marketplace de hasta 20 creadores a partir de sus ID de Creator Marketplace. Devuelve el desglose de seguidores por edad, género, país y dispositivo, la mediana de vistas, las tasas de interacción y de crecimiento, las tarifas iniciales y la identidad del creador.

El ID de Creator Marketplace, que Top Videos devuelve como creator_id en sus filas, escrito con 5 a 32 dígitos. Un ID de usuario común de TikTok no identifica una ficha, y otros formatos se rechazan con un error 400.

Los creadores que se unieron al Creator Marketplace de TikTok y configuraron un perfil; TikTok define los requisitos, incluidos umbrales de edad y de seguidores que varían según el proyecto. Un ID sin ficha se omite y no se cobra, y si se omiten todos los ID, la tarea falla y los créditos se devuelven. Cada ficha devuelta cuesta 0.5 créditos.

Cuatro cortes de los seguidores del creador: rangos de edad con etiquetas como 18-24 o 55+, género, país y marca de teléfono, cada entrada con una proporción de 0 a 1. Los países incluyen además country_code y un conteo de seguidores muestreados.

starting_price entrega el monto y la moneda que el creador indica como precio inicial de un video patrocinado. Es una cifra de partida: cada creador fija su tarifa inicial y el precio final se acuerda por proyecto.

No, la consulta es por ID de Creator Marketplace. Los candidatos salen de TikTok Creative Center Top Videos, donde cada fila de la clasificación trae un creator_id.

No de parte de TikTok. La consulta funciona solo con su clave de API de SocQ, sin cuenta de marca ni aprobación como socio.