API de Detalles de la música de TikTok
Lee los detalles de un sonido de TikTok con music_id: title, author_name, album, use_count, is_original e is_copyrighted, a $0.56 por cada 1000 llamadas.
music_idtambién acepta el enlace de la página del sonido https://www.tiktok.com/music/<nombre>-<ID>- Una llamada lee un sonido y devuelve un objeto
- Las llamadas fallidas y los resultados vacíos no se cobran.
Salud de la API
- Salud 24 h
- Normal
- Saludable / normal
- Disponible
Últimas 24 horas
Últimos 30 días
1Solicitud
POST /api/v1/social { "platform": "tiktok", "action": "music_detail", "params": { "music_id": "7252896191606835201" } }2Respuesta JSON
{ "results": { "author_name": "T•••t", "title": "Enchanted (Taylor's Version)", "album": "Speak Now (Taylor's Version)", "duration_seconds": 60, … } }3Campos
author_name title album duration_seconds T•••t Enchanted (Taylor's Version) Speak Now (Taylor's Version) 60 4CSV
tiktok-music_detail-sample.csv id,url,title,author_name,author_username,author_id,author_sec_uid,album,duration_seconds,duration_sec,use_count,is_original,is_commercial,is_copyrighted,is_private,cover_image_url,audio_url,platform
music_id y sale un objeto JSON con campos como title y use_count, que se muestra como tabla de campos y se puede descargar en CSV.Qué datos obtienes
La tabla muestra una llamada real para 7252896191606835201, obtenida el 21 de noviembre de 2026, 07:21 (UTC), que devolvió un objeto; las barras grises marcan datos personales eliminados (••• en el CSV). En tus llamadas recibes estos campos, tal como figuran en la referencia de campos.
| id | url | title | author_name | author_username | author_id | author_sec_uid | album | duration_seconds | duration_sec | use_count | is_original | is_commercial | is_copyrighted | is_private | cover_image_url | audio_url | platform |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| https://www.tiktok.com/music/Enchanted-(Taylor's-Version)-7252896191606835201 | Enchanted (Taylor's Version) | T•••t | null | null | null | Speak Now (Taylor's Version) | 60 | 60 | 439400 | false | null | true | null | https://p16-common.tiktokcdn-us.com/tos-alisg-v-2774/ooblA8sF6kVQIgDoS6ZeutinBeACpIZPVEQCAB~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9584&t=4d5b0474&ps=933b5bde&shp=08d74b56&shcp=81f88b70&idc=useast5 | https://sf16.tiktokcdn-us.com/obj/tos-alisg-ve-2774/oQMfgHZ2yCAQeFFzvD7YinadqsaaALfRnJ4DEg | tiktok |
Casos de uso
Comprobar cuánto se usa un sonido
Lee
use_countpara ver cuántos videos usaron el sonido y vuelve a leerlo más tarde para comparar.Leer las marcas de derechos y de biblioteca
is_copyrightedmarca si la música está protegida por derechos de autor,is_commercialsi está en la biblioteca comercial eis_privatesi es privada.Encontrar al autor de un sonido original
Lee
author_usernameyauthor_id. Los sonidos originales también traenauthor_sec_uid, así que puedes leer esa cuenta a continuación.Obtener el álbum y un enlace de escucha
Lee
album,duration_secondsyaudio_url.
Límites y detalles a tener en cuenta
music_ides obligatorio. Es un ID de música (elidde una fila demusic_searchomusic_chart, o el id dentro demusicen una fila de video), o un enlace de página de sonido.author_sec_uidsolo existe en los sonidos originales.use_countes el número de videos que usaron este sonido.audio_urlva firmado y caduca, así que no lo guardes a largo plazo.
Precios
Pagas $0.000556 por llamada. Cada llamada lee un resultado. Las llamadas fallidas y los resultados vacíos no se cobran.
| Llamadas | Costo |
|---|---|
| 10,000 | $5.56 |
| 100,000 | $55.56 |
| 1,000,000 | $555.56 |
Los totales se calculan con el precio de lista por llamada.
Ejemplos de código
#curl -X POST 'https://api.everyinfra.com/api/v1/social' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"platform": "tiktok",
"action": "music_detail",
"params": {
"music_id": "7252896191606835201"
}
}'Definición OpenAPI (JSON)Los ejemplos leen la clave de la variable de entorno EVERYINFRA_API_KEY; el código copiado nunca contiene tu clave.
Referencia de API
Consulta los parámetros, los campos de respuesta, los errores y la facturación de music_detail, y copia la página o ábrela en Markdown para dársela a un asistente de IA.
Prompt para IA
#Ayúdame a escribir un script de recopilación de datos con el endpoint de EveryInfra TikTok: Detalles de la música (tiktok/music_detail).
Cómo funciona el endpoint:
- Solicitud: POST https://api.everyinfra.com/api/v1/social con la cabecera Authorization: Bearer <clave API>. Lee la clave de la variable de entorno EVERYINFRA_API_KEY y no la escribas en el código.
- En el cuerpo de la solicitud, pon platform en tiktok y action en music_detail, y los parámetros dentro de params.
- Parámetros obligatorios:
- music_id: Un ID numérico de música, como el id de music_search o music_chart o el music.id de un video, o un enlace https://www.tiktok.com/music/<nombre>-<ID>.
- Devuelve un objeto. Campos principales: id, url, title, author_name, author_username, author_id, author_sec_uid, album, duration_seconds, duration_sec, use_count, is_original; 17 campos en total, lista completa en https://api.everyinfra.com/api/v1/social/catalog?platform=tiktok.
- Cuerpo de solicitud de ejemplo:
{
"platform": "tiktok",
"action": "music_detail",
"params": {
"music_id": "7252896191606835201"
}
}
- Precio: $0.56 por 1.000 solicitudes; los resultados fallidos y vacíos no se cobran.
- Para decenas o cientos de objetivos, añade "mode": "async" al cuerpo: recibes un job_id al instante y consultas GET https://api.everyinfra.com/api/v1/jobs/{job_id} para obtener el resultado.
- Ante un 422, corrige la solicitud con los nombres de parámetros y los valores admitidos que sugiere el error; ante un 429 o un 503, espera lo que indique Retry-After y vuelve a intentarlo.
Antes de escribir código, pregúntame qué objetivos necesito, cuántos, qué campos y en qué formato quiero el resultado; luego confirma conmigo el plan y el coste aproximado.Parámetros de la solicitud
#| Nombre | Ubicación | Tipo | Obligatorio | Por defecto | Descripción |
|---|---|---|---|---|---|
Authorization | header | string | Sí | - | Bearer seguido de tu clave de API. Créala en la consola; nunca la pongas en una URL ni en un repositorio de código. |
platform | body | string | Sí | tiktok | Identificador de la plataforma, valor fijo. |
action | body | string | Sí | music_detail | Identificador de la capacidad, valor fijo. |
music_id | body.params | string | Sí | - | Un ID numérico de música, como el id de music_search o music_chart o el music.id de un video, o un enlace https://www.tiktok.com/music/<nombre>-<ID>. |
Ejemplo de respuesta
#{ "id": "req_…", "platform": "tiktok", "action": "music_detail", "results": { "id": "•••", "url": "https://www.tiktok.com/music/Enchanted-(Taylor's-Version)-7252896191606835201", "title": "Enchanted (Taylor's Version)", "author_name": "T•••t", "album": "Speak Now (Taylor's Version)", "duration_seconds": 60, "use_count": 439400, "is_original": false, "is_copyrighted": true, "cover_image_url": "https://p16-common.tiktokcdn-us.com/tos-alisg-v-2774/ooblA8sF6kVQIgDoS6ZeutinBeACpIZPVEQCAB~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9584&t=4d5b0474&ps=933b5bde&shp=08d74b56&shcp=81f88b70&idc=useast5", "audio_url": "https://sf16.tiktokcdn-us.com/obj/tos-alisg-ve-2774/oQMfgHZ2yCAQeFFzvD7YinadqsaaALfRnJ4DEg", "platform": "tiktok", "duration_sec": 60 }, "billing": { "charged": …, "charged_usd": …, "balance_after_usd": …, … }, "quota": { … }}
Campos de la respuesta
#Los datos están en results. La tabla lista los campos que puede tener cada registro; los valores que la plataforma no muestra nunca se inventan.
| Campo | Significado |
|---|---|
id | Identificador único del registro en la plataforma. Solo es único dentro de una plataforma; puede repetirse entre plataformas. |
url | Enlace al registro en la plataforma. |
title | Título. null cuando la plataforma no usa títulos (por ejemplo publicaciones solo de texto). |
author_name | Nombre visible del autor. |
author_username | Nombre de usuario del autor (@usuario), normalmente utilizable en URL. |
author_id | Identificador único del autor en la plataforma. |
author_sec_uid | Conserva el significado de la plataforma |
album | Conserva el significado de la plataforma |
duration_seconds | Duración en segundos. null en contenido que no es video ni audio. |
duration_sec | Conserva el significado de la plataforma |
use_count | Conserva el significado de la plataforma |
is_original | Conserva el significado de la plataforma |
is_commercial | Conserva el significado de la plataforma |
is_copyrighted | Conserva el significado de la plataforma |
is_private | Conserva el significado de la plataforma |
cover_image_url | Conserva el significado de la plataforma |
audio_url | Conserva el significado de la plataforma |
platform | Identificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok). |
Errores y facturación
#- 401
- Falta la clave o no es válida.
- 402
- Saldo insuficiente. Recarga primero.
- 422
- Nombre o valor de parámetro incorrecto. Corrígelo según las opciones indicadas en el error. Sin cargo.
- 429
- Se alcanzó el límite de solicitudes por minuto. Espera el tiempo indicado en Retry-After y vuelve a intentarlo.
- 503
- No se pudo completar. El cargo retenido vuelve a tu saldo. Si el resultado es incierto, compruébalo antes de reenviar.
- 200 vacío
- Sin datos. Sin cargo.
Preguntas frecuentes
¿Qué campos devuelve la API de detalles de música?
id, url, title, author_name, author_username, author_id, author_sec_uid, album, duration_seconds, use_count, is_original, is_commercial, is_copyrighted, is_private, cover_image_url y audio_url.
¿De dónde saco el ID de música?
Tómalo del id de una fila de music_search o music_chart, del id dentro de music en una fila de video, o pega el enlace de la página del sonido.
¿Cuánto cuesta leer los detalles de un sonido?
Cuesta $0.000556 por llamada, o $0.56 por cada 1000 llamadas. Cada llamada lee un resultado. Las llamadas fallidas y los resultados vacíos no se cobran.
Capacidades de TikTok relacionadas
Con la misma clave de API de EveryInfra puedes llamar a los demás endpoints de TikTok, por ejemplo sound_videos.
- Búsqueda
search$0.56 por cada 1000 llamadasBusca en TikTok mediantekeywordy elige la pestaña concontent_type: videos, cuentas o la vista general. - Detalles
profile$0.56 por cada 1000 llamadasResuelve unusernamede TikTok y devuelve biografía, enlace externo, seguidores, seguidos, likes, número de videos y fecha de creación. - Videos del usuario
user_videos$0.56 por cada 1000 llamadasObtiene videos públicos delusernamey permite filtrar por likes mínimos (min_likes), fijar una fecha máxima de publicación (until) u ordenar consort. - Detalles del video
video$0.56 por cada 1000 llamadasAbre laurlde un video de TikTok y recoge texto, autor, fecha y contadores de likes, comentarios, compartidos y vistas. - Comentarios
comments$0.56 por cada 1000 llamadasLee comentarios de laurldel video y distingue respuestas, fijado y reacción del autor cuando existen. - Contenido por hashtag
hashtag$0.56 por cada 1000 llamadasBusca videos publicados bajo elhashtagindicado, con o sin#, conservando autor y métricas por publicación. - Seguidores
followers$0.56 por cada 1000 llamadasRecibeusernamey devuelve contadores y señales de conexión agregadas, conchannelcompatible. - Transcripción
transcript$0.56 por cada 1000 llamadasExtrae el texto disponible del video indicado porurl, con segmentos cuando existen. - Búsqueda de productos de la tienda
shop_search$0.56 por cada 1000 llamadasBusca productos de TikTok Shop mediantekeyword, con país y página opcionales. - Datos del creador de la tienda
shop_creator$0.56 por cada 1000 llamadasConsulta un creador de Shop medianteusernamey país opcional, devolviendo categorías y contadores públicos. - Búsqueda de hashtags
hashtag_search$0.81 por cada 1000 llamadasBusca hashtags de TikTok porkeyword. - Búsqueda de música
music_search$0.81 por cada 1000 llamadasBusca en la biblioteca de sonidos de TikTok porkeyword, como una canción o un artista. - Lista de éxitos musicales
music_chart$0.81 por cada 1000 llamadasLee una lista musical de TikTok:top50(por defecto) oviral50. - Búsqueda de cuentas
user_search$0.56 por cada 1000 llamadasBusca cuentas de TikTok porkeyword, en el orden de la búsqueda de TikTok. - Videos con un sonido
sound_videos$0.56 por cada 1000 llamadasLista los videos de TikTok que usan un sonido, a partir de sumusic_ido del enlace de la página del sonido. - Respuestas a comentarios
comment_replies$0.56 por cada 1000 llamadasLee las respuestas a un comentario de un video de TikTok, con laurldel video y eliddel comentario que devuelvecomments. - Más vendidos de la tienda
shop_hot_products$0.81 por cada 1000 llamadasLee la lista de más vendidos de TikTok Shop de un mercado: ID, JP, MX, MY (por defecto), PH, SG, TH o VN. - Productos de la tienda por categoría
shop_category_products$0.81 por cada 1000 llamadasLista productos de TikTok Shop de una categoría porcategory_id, como 601450 (belleza y cuidado personal), en el mercado elegido. - Cuentas seguidas
following$0.64 por cada 1000 llamadasLista las cuentas que sigue un usuario de TikTok, por su usuario. - Enlaces de descarga del video
video_download$0.64 por cada 1000 llamadasObtiene los enlaces de descarga de un video de TikTok sin marca de agua, a partir de suurl. - Sala en directo
live_room$0.81 por cada 1000 llamadasComprueba si una cuenta de TikTok está en directo ahora, por su usuario. - Productos de una tienda
shop_products$0.81 por cada 1000 llamadasLista los productos de una tienda de TikTok Shop a partir de sushop_ido del enlace de la tienda, en el mercado elegido. - Reseñas de un producto de la tienda
shop_product_reviews$0.76 por cada 1000 llamadasLee reseñas de compradores de un producto de TikTok Shop a partir de suproduct_ido enlace. - Hashtags en tendencia
trending_hashtags$0.81 por cada 1000 llamadasLee los hashtags en tendencia de TikTok en un mercado durante los últimos 7, 30 o 90 días, opcionalmente de un sector. - ID de usuario por nombre
resolve_user$0.56 por cada 1000 llamadasConvierte unusernamede TikTok (con o sin @), un enlace de perfil o unsec_uiden eluser_idnumérico de la cuenta, susec_uid, elusernameactual y elurldel perfil. - Reconocimiento de enlaces
resolve_links$0.56 por cada 1000 llamadasLee el ID del video de un enlace de TikTok enurl, incluidos los enlaces cortos de vm.tiktok.com y vt.tiktok.com. - Detalles del hashtag
hashtag_detail$0.56 por cada 1000 llamadasConsulta un hashtag de TikTok a partir dehashtag(el nombre, con o sin #, un enlace de la etiqueta o el ID numérico):hashtag_id,hashtag_name,url,video_countyview_countexactos, eis_commercial.