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_id tambié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
Normal

Últimas 24 horas

Últimos 30 días

  1. 1Solicitud

    POST /api/v1/social
    {
      "platform": "tiktok",
      "action": "music_detail",
      "params": {
        "music_id": "7252896191606835201"
      }
    }
  2. 2Respuesta JSON

    {
      "results": {
        "author_name": "T•••t",
        "title": "Enchanted (Taylor's Version)",
        "album": "Speak Now (Taylor's Version)",
        "duration_seconds": 60,
        …
      }
    }
  3. 3Campos

    author_nametitlealbumduration_seconds
    T•••tEnchanted (Taylor's Version)Speak Now (Taylor's Version)60
  4. 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

Entra una solicitud con 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.

idurltitleauthor_nameauthor_usernameauthor_idauthor_sec_uidalbumduration_secondsduration_secuse_countis_originalis_commercialis_copyrightedis_privatecover_image_urlaudio_urlplatform
https://www.tiktok.com/music/Enchanted-(Taylor's-Version)-7252896191606835201Enchanted (Taylor's Version)T•••tnullnullnullSpeak Now (Taylor's Version)6060439400falsenulltruenullhttps://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=useast5https://sf16.tiktokcdn-us.com/obj/tos-alisg-ve-2774/oQMfgHZ2yCAQeFFzvD7YinadqsaaALfRnJ4DEgtiktok

Casos de uso

  • Comprobar cuánto se usa un sonido

    Lee use_count para 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_copyrighted marca si la música está protegida por derechos de autor, is_commercial si está en la biblioteca comercial e is_private si es privada.

  • Encontrar al autor de un sonido original

    Lee author_username y author_id. Los sonidos originales también traen author_sec_uid, así que puedes leer esa cuenta a continuación.

  • Obtener el álbum y un enlace de escucha

    Lee album, duration_seconds y audio_url.

Límites y detalles a tener en cuenta

  • music_id es obligatorio. Es un ID de música (el id de una fila de music_search o music_chart, o el id dentro de music en una fila de video), o un enlace de página de sonido.
  • author_sec_uid solo existe en los sonidos originales.
  • use_count es el número de videos que usaron este sonido.
  • audio_url va 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.

LlamadasCosto
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

#
bash
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.

POST

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

#
NombreUbicaciónTipoObligatorioPor defectoDescripción
AuthorizationheaderstringSí-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.
platformbodystringSítiktokIdentificador de la plataforma, valor fijo.
actionbodystringSímusic_detailIdentificador de la capacidad, valor fijo.
music_idbody.paramsstringSí-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

#
Obtenida el 21 de noviembre de 2026, 07:21 (UTC) llamando a esta API con los parámetros del ejemplo de código de arriba. results y count son la respuesta real de esa llamada, sin información personal (nombres, usuarios, avatares, enlaces de perfil, datos de contacto). id, billing y quota cambian en cada llamada, por eso solo se muestra su estructura.
json
{  "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.

CampoSignificado
idIdentificador único del registro en la plataforma. Solo es único dentro de una plataforma; puede repetirse entre plataformas.
urlEnlace al registro en la plataforma.
titleTítulo. null cuando la plataforma no usa títulos (por ejemplo publicaciones solo de texto).
author_nameNombre visible del autor.
author_usernameNombre de usuario del autor (@usuario), normalmente utilizable en URL.
author_idIdentificador único del autor en la plataforma.
author_sec_uidConserva el significado de la plataforma
albumConserva el significado de la plataforma
duration_secondsDuración en segundos. null en contenido que no es video ni audio.
duration_secConserva el significado de la plataforma
use_countConserva el significado de la plataforma
is_originalConserva el significado de la plataforma
is_commercialConserva el significado de la plataforma
is_copyrightedConserva el significado de la plataforma
is_privateConserva el significado de la plataforma
cover_image_urlConserva el significado de la plataforma
audio_urlConserva el significado de la plataforma
platformIdentificador 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.

Errores

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.

Con la misma clave de API de EveryInfra puedes llamar a los demás endpoints de TikTok, por ejemplo sound_videos.

Google Analytics solo si aceptas. Privacidad