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ámetros | Obligatorio | Descripción |
|---|---|---|
chart_type | Opcional | Elecció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_limit | Opcional | Nú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.
- 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.
- 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.
- 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.
- 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.
- 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.
APIs relacionadas
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.
- TikTok Profiles API
- TikTok Hashtags API
- TikTok Comments API
- TikTok Search API
- TikTok Comment Replies API
- TikTok Followers List API
- TikTok Following List API
- TikTok Live Room Info API
- TikTok Search Users API
- TikTok Top Search API
- TikTok User Live API
- TikTok Audience Demographics API
- TikTok Similar Accounts API
- TikTok Reposts API
- TikTok Playlists API
- TikTok Hashtag Views API
- TikTok Sound Search API
- TikTok Live Search API
- TikTok Photo Search API
- TikTok Trending Searches API
- TikTok Creator Search Insights API
- TikTok Live Ranking API
- TikTok Live Shopping API
- TikTok Fake Views Checker API
- TikTok Comment Keywords API