tiktok/
live-ranking

Obtenga la clasificación diaria de creadores de TikTok LIVE en una sola llamada: hasta 99 anfitriones con posición, puntuación basada en regalos, ID de usuario, usuario, nombre visible, seguidores y enlace al perfil.

TikTok Live Ranking API

Sin datos de entrada
Hasta 99 anfitriones
Puntuación por regalos
0.5 créditos por solicitud
Listo
Listo

Envíe la solicitud vacía. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

TikTok Live Ranking

La clasificación diaria de TikTok LIVE es la tabla del día de los anfitriones en vivo, ordenada por una puntuación que sale de los regalos que los espectadores envían durante sus transmisiones, y cada entrada muestra la posición, la puntuación y los seguidores del anfitrión. Leerla permite ver a qué anfitriones están apoyando los espectadores hoy, cómo se mueven los primeros lugares y qué cuentas pequeñas reciben más apoyo del que sugiere el tamaño de su audiencia.

Funcionalidades de la TikTok Live Ranking API

  • La tabla completa, sin parámetrosLa solicitud no lleva datos de entrada y devuelve la clasificación diaria actual con hasta 99 anfitriones, cada uno con su rank.
  • Puntuación junto al tamaño de la audienciascore es el valor de clasificación basado en regalos y followers_count el total de seguidores del anfitrión, así que el apoyo y la audiencia se comparan sin una segunda consulta.
  • Identidad del anfitrión en cada filaauthor entrega el ID de usuario, el usuario, el nombre visible, el enlace al perfil y el avatar del anfitrión.

Parámetros de la TikTok Live Ranking API

Listo para enviar

Este endpoint no requiere parámetros de solicitud. Envíe el objeto JSON vacío tal cual.

{}

Cómo usar la TikTok Live Ranking API

Envíe una solicitud vacía y lea los anfitriones clasificados.

  1. Envíe {} por POST a /v1/tiktok/live-ranking.
  2. Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded.
  3. Lea los anfitriones en results.items y devuelva results.next_cursor mientras has_more sea true.
curl -X POST "https://api.socq.ai/v1/tiktok/live-ranking" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

# Each item has rank, score, author and followers_count.

Casos de uso de la TikTok Live Ranking API

  • Seguir la tabla a lo largo del día: Descargue la clasificación a horas fijas y grafique el rank y el score de cada anfitrión para ver quién sube y cuándo cambia el orden.
  • Buscar anfitriones para agencias y patrocinadores: Divida score entre followers_count para encontrar anfitriones cuyos espectadores dan mucho en relación con el tamaño de su audiencia, y luego prepare una lista corta para contratarlos o patrocinarlos.

Consejos de expertos para la TikTok Live Ranking API

  • Programe las consultas siempre a la misma hora, porque una puntuación leída al mediodía y otra leída a medianoche cubren partes distintas del mismo día.
  • La clasificación no trae el estado en vivo. Relacione a los anfitriones por author.id y envíe sus nombres de usuario a TikTok User Live para ver quiénes están transmitiendo ahora.

Además de la TikTok Live Ranking API, use estas APIs cuando necesite otro tipo de datos públicos de TikTok.

  • TikTok Profiles API — Obtiene por nombre de usuario la identidad del perfil público, biografías, indicadores de cuenta y conteos de audiencia.
  • TikTok Followers List API — Recolecta perfiles normalizados visibles en listas públicas de seguidores, conservando el contexto de origen y las métricas compatibles.
  • TikTok Following List API — Recolecta los perfiles públicos seguidos por cuentas de TikTok, con identidad normalizada, biografías, métricas visibles y contexto de la cuenta de origen.
  • TikTok User Live API — Comprueba si los nombres de usuario están en vivo o fuera de línea, y obtiene los detalles disponibles de la transmisión.
  • TikTok Audience Demographics API — Muestra por nombre de usuario de qué países provienen los seguidores de un creador, con el porcentaje de la audiencia de cada país.
  • TikTok Live Search API — Encuentra por palabra clave transmisiones en vivo que están al aire, con anfitriones, títulos y espectadores actuales.

Explorar otras plataformas

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

TikTok Live Ranking API — FAQ

TikTok Live Ranking API es una interfaz programática para leer la clasificación diaria de creadores de TikTok LIVE, que no necesita datos de entrada. Devuelve hasta 99 anfitriones, cada uno con posición, puntuación basada en regalos, ID de usuario, usuario, nombre visible y seguidores.

score es el valor con el que TikTok clasifica hoy a los anfitriones, según los regalos que recibieron sus transmisiones. Es una puntuación de clasificación, no un pago en ninguna moneda.

No con este endpoint. No recibe datos de entrada y devuelve la clasificación diaria actual, así que conserve sus propias copias si necesita un historial.

Las posiciones se mueven a medida que llegan regalos durante el día. Cada consulta cuesta 0.5 créditos fijos por toda la tabla, así que una programación cada hora cuesta 12 créditos al día.

No. Clasifica a los anfitriones que los recibieron, con la posición, la puntuación y el perfil de cada uno, y no incluye una lista de quienes regalan.