tiktok/
popular-songs

Obtenga el ranking de canciones Top 50 o Viral 50 de TikTok, con nombres de pistas, artistas, ID de sonido y conteos de videos disponibles, para armar una lista de música que revisar.

TikTok Popular Songs API

Top 50
Viral 50
ID de sonido
0.5 créditos por resultado
Listo
README

Por SocQ · Actualizado el

TikTok Popular Songs

Un sonido de TikTok es el audio asociado a una publicación, y la app de TikTok ofrece los rankings de canciones Top 50 y Viral 50. Cada registro devuelto identifica un sonido concreto con su título, artista e ID de sonido, de modo que puede armar una lista de música y conectar cada entrada con los detalles del sonido o con los videos que lo usan.

Funcionalidades de la TikTok Popular Songs API

  • Elija uno de los dos rankings de cancionesDefina chart_type como top para el Top 50 o como viral para el Viral 50. Son dos rankings con nombre en la app de TikTok; elija el que desea revisar y solicite hasta 50 entradas.
  • Identifique el sonido exacto detrás del título de una canciónLea juntos el título, el artista, el ID de sonido, la portada y la duración. El ID de sonido ayuda a distinguir fragmentos de audio con el mismo nombre y permite consultar ese sonido concreto con TikTok Song o TikTok Song Videos.
  • Lea los conteos de uso del sonido disponiblesCuando el origen proporciona un conteo, metrics.videos_count indica cuántos videos usan ese sonido. Es un conteo de videos, no de oyentes, reproducciones ni Me gusta; un conteo no disponible queda en null.

Parámetros de la TikTok Popular Songs API

ParámetrosObligatorioDescripción
chart_typeOpcionalElección opcional del ranking: top selecciona el Top 50 de la app de TikTok; viral selecciona el Viral 50. El valor predeterminado es top. Por ejemplo, cambie el valor del ejemplo a viral para solicitar el otro ranking.
results_limitOpcionalNúmero máximo opcional de canciones, un entero de 1 a 50; el valor predeterminado es 20. Por ejemplo, 10 solicita hasta diez entradas del ranking seleccionado. El origen puede devolver menos, y la paginación de resultados no amplía este límite.

Cómo usar la TikTok Popular Songs API

La solicitud inicia una tarea de recopilación en segundo plano, por lo que su primera respuesta entrega un ID de tarea y no los datos finales; use ese ID para comprobar el avance y obtener los resultados.

  1. Elija chart_type: top para el Top 50 o viral para el Viral 50. Si lo omite, la API usa top; results_limit tiene 20 como valor predeterminado y acepta un entero de 1 a 50.
  2. Reemplace $SOCQ_API_KEY por su clave de API, o defina esa variable de entorno. Envíe la solicitud JSON por POST a /v1/tiktok/popular-songs con el encabezado Authorization y guarde el task_id devuelto.
  3. La primera respuesta contiene un ID de tarea porque la recopilación se ejecuta en segundo plano. Consulte GET /v1/tasks/{task_id}; queued, running y retrying indican que la tarea sigue en curso. Lea los resultados tras succeeded o revise error_message tras failed.
  4. Lea data.results.items. Cada elemento describe un sonido concreto; audio.id es su ID de sonido, audio.artist indica el artista y metrics.videos_count es el conteo disponible de videos que lo usan. Un arreglo items vacío significa que no se devolvieron registros.
  5. Si data.results.has_more es true, pase next_cursor sin cambios como cursor a GET /v1/tasks/{task_id}?cursor=... y continúe hasta que has_more sea false. Esto lee otra página de la misma tarea guardada; no aumenta el límite de recopilación del ranking por encima de 50.
curl -X POST "https://api.socq.ai/v1/tiktok/popular-songs" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"chart_type":"top","results_limit":20}'

Casos de uso de la TikTok Popular Songs API

  • Preparar una hoja de revisión musical: Elija el Top 50 o el Viral 50 y exporte a una tabla los títulos, artistas, ID de sonido, duraciones y conteos de videos disponibles. Su equipo puede abrir las páginas de los sonidos y revisar qué fragmentos se ajustan a una idea de contenido.
  • Reunir ejemplos de videos que usan un sonido: Pase los ID de sonido devueltos como music_ids a TikTok Song Videos para reunir ejemplos de videos públicos. Revise esos videos usted mismo para entender cómo se usa un fragmento; esta API de ranking no realiza ese análisis.
  • Comparar instantáneas del ranking recopiladas por separado: Guarde el chart_type elegido, los ID de sonido, los conteos de videos disponibles y collected_at cada vez que ejecute una tarea. Una sus tablas guardadas por ID de sonido para comparar las canciones devueltas y los conteos de uso a lo largo del tiempo; la API no proporciona clasificaciones históricas.

Consejos de expertos para la TikTok Popular Songs API

  • Mantenga chart_type constante al comparar ejecuciones guardadas. Pasar de top a viral cambia el ranking elegido, así que una lista de canciones distinta no demuestra por sí sola un aumento o una caída de popularidad.
  • Use audio.id para vincular registros entre tareas y para consultar TikTok Song o TikTok Song Videos. Un título por sí solo no distingue entre fragmentos de sonido distintos con el mismo nombre.
  • Si audio.url es null, conserve el ID de sonido y la URL pública de la página del sonido para seguir investigando. Cuando se proporcione una URL de audio, trátela como un enlace de medios disponible en el momento de la recopilación y no como una dirección de descarga permanente.

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

  • TikTok Videos API — Obtiene el creador, la descripción, el contenido multimedia, la música, las etiquetas, las menciones y la interacción desde URLs de videos.
  • TikTok User Videos API — Recolecta videos públicos del feed de un perfil por nombre de usuario, con descripciones, creadores, contenido multimedia, marcas de tiempo, interacción y contexto de la cuenta de origen.
  • TikTok Trending Feed API — Recolecta el feed actual de videos públicos de una región, con campos de creador, descripción, portada, marca de tiempo e interacción visible.
  • TikTok Video Transcript API — Extrae el texto de transcripción disponible, el idioma, el formato y el contexto de origen desde URLs de videos públicos.
  • TikTok Song API — Obtiene los metadatos de un sonido público por ID de clip o URL de música.
  • TikTok Song Videos API — Recolecta videos públicos que usan los IDs de sonido indicados.

Explorar otras plataformas

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

TikTok Popular Songs API — FAQ

TikTok Popular Songs API es una interfaz para leer el ranking de canciones Top 50 o Viral 50 de la app de TikTok. Elija chart_type y un límite de resultados para obtener nombres de sonidos, artistas, ID de sonido, portadas, duraciones y conteos de uso en videos disponibles.

Seleccionan dos rankings con nombre de la app de TikTok: top es el Top 50 y viral es el Viral 50. Si se omite chart_type, la API usa top. La respuesta no explica la fórmula del ranking ni ofrece una puntuación de crecimiento.

No. Esta interfaz acepta chart_type y results_limit, además de un callback_url opcional para el aviso de finalización de la tarea. No ofrece filtros por país, periodo del ranking, nuevas entradas ni música comercial.

No. results_limit va de 1 a 50. Un cursor de resultados permite leer otra página de registros ya guardados por esa tarea; no recopila entradas adicionales del ranking.

metrics.videos_count es el número de videos que se informa que usan el sonido. No mide oyentes, reproducciones ni Me gusta. Un conteo null significa que el origen no proporcionó esa medición, mientras que cero es un valor realmente devuelto.

Tome audio.id del registro de la canción y páselo en music_ids a TikTok Song Videos. Para obtener los detalles de un sonido, use ese ID con TikTok Song. Son solicitudes distintas.

No. audio.url puede ser null aunque el nombre, el artista y el ID de sonido estén disponibles. Cuando se devuelve una URL, puede usarla para inspeccionar el audio disponible; la API no garantiza que el enlace siga siendo accesible.

Cada registro de canción devuelto cuesta 0.5 créditos, sin cargo base. Un límite de 20 estima 10 créditos; si la tarea devuelve 12 canciones, el cargo final es de 6 créditos. Un límite de 50 estima 25 créditos.