API gratuita de consulta musical
Consulta un ISRC, un UPC o un enlace de tienda y recibe JSON limpio. Sin clave y sin cuenta. Usa las mismas fuentes abiertas que nuestras herramientas gratuitas.
Qué devuelve la API
La API de consulta devuelve el lanzamiento que hay detrás de un código de grabación (ISRC), un código de barras (UPC o EAN) o un enlace de Apple Music: título, artista, álbum, fecha de lanzamiento, sello, línea de copyright y códigos relacionados. Cada respuesta enumera las fuentes de datos y un breve texto de atribución.
Los resultados vienen de bases de datos abiertas, así que un lanzamiento nuevo o un catálogo pequeño puede faltar. Que no haya resultado no prueba que un código sea incorrecto.
Cómo usar bien los datos
Muestra los nombres de las fuentes que acompañan a cada respuesta y mantén visible la línea Powered by WBBT. No presentes los datos como completos ni como prueba de quién es el titular de una grabación.
La API no admite enlaces de Spotify. Pégalos en las herramientas gratuitas de este sitio.
Ejemplos
Consulta por código
Envía una solicitud GET con isrc o upc en la cadena de consulta. Son códigos públicos, así que pueden ir en una dirección.
curl "https://wbbt.net/api/v1/lookup?isrc=USABC2400001"
const res = await fetch("https://wbbt.net/api/v1/lookup?upc=036000291452");
const json = await res.json();
if (json.ok) console.log(json.data.result.title, json.poweredBy);Consulta por enlace
Los enlaces de tiendas pueden llevar parámetros de seguimiento, así que envíalos en un cuerpo JSON con POST y nunca en la dirección.
curl -X POST https://wbbt.net/api/v1/lookup \
-H "Content-Type: application/json" \
-d '{"url":"https://music.apple.com/us/album/example-album/1234567890"}'Respuesta
Cada respuesta tiene ok, version, data, sources, attribution y poweredBy. Un campo sin valor es null.
{
"ok": true,
"version": "1",
"data": {
"type": "recording",
"query": { "isrc": "USABC2400001" },
"results": [
{
"title": "Night Drive",
"artist": "Luna Vale",
"album": null,
"releaseDate": "2024-05-17",
"isrcs": ["USABC2400001"],
"isrcMatch": "exact",
"upc": null,
"label": null,
"distributedByWbbt": false,
"pageUrls": { "isrc": "https://wbbt.net/isrc/USABC2400001", "upc": null }
}
]
},
"sources": [{ "name": "MusicBrainz", "url": "https://musicbrainz.org", "attribution": "Data from MusicBrainz (CC0)." }],
"cached": false,
"poweredBy": "Powered by WBBT Records (https://wbbt.net/tools/api)"
}Límites
- 30 solicitudes por minuto y 1000 al día por dirección.
- Las respuestas pueden guardarse en caché unos minutos, y los datos que las respaldan hasta un día.
- No hace falta clave. Los límites pueden cambiar, y el campo version indica qué esquema recibes.
Errores
- 400 invalid_request: falta el código, tiene un formato incorrecto o no pasa su dígito de control.
- 404 not_found: no se encontró nada para este código.
- 422 unsupported_link: el enlace no es un enlace de Apple Music.
- 429 rate_limited: espera los segundos indicados en la cabecera Retry-After.
- 503 unavailable: una fuente de datos está ocupada, así que inténtalo de nuevo en breve.
Atribución
Muestra las fuentes que se nombran en cada respuesta y mantén la línea Powered by WBBT. Se agradece un enlace a wbbt.net/tools/api.
Preguntas
¿Necesito una clave de API?
No. La API es abierta, no usa clave y se limita por dirección. Si necesitas más solicitudes, escribe a [email protected].
¿Puedo llamarla desde una página web?
Sí, las solicitudes GET por código. Envían cabeceras CORS abiertas. Los enlaces van en el cuerpo de un POST, así que llama a esa parte desde tu propio servidor.
¿Por qué hay una página permanente para cada código?
Cada respuesta incluye un pageUrl, una página pública en wbbt.net para ese código. Enlázala si quieres que la gente vea todos los datos.
¿Vas a lanzar tu propia música?
Mira lo que WBBT ofrece a artistas y sellos independientes, o envíanos tu música.