WBBT Records
WBBT RECORDSServiçosMCP IAPreçosSobreBlogFAQ
ENTRAR

API gratuita de consulta musical

Consulte um ISRC, um UPC ou um link de loja e receba JSON limpo. Sem chave e sem conta. Usa as mesmas fontes abertas das nossas ferramentas gratuitas.

O que a API devolve

A API de consulta devolve o lançamento por trás de um código de gravação (ISRC), um código de barras (UPC ou EAN) ou um link do Apple Music: título, artista, álbum, data de lançamento, selo, linha de copyright e códigos relacionados. Cada resposta lista as fontes de dados e um breve texto de atribuição.

Os resultados vêm de bases de dados abertas, então um lançamento novo ou um catálogo pequeno pode faltar. A ausência de resultado não prova que um código esteja errado.

Como usar bem os dados

Mostre os nomes das fontes que acompanham cada resposta e mantenha visível a linha Powered by WBBT. Não apresente os dados como completos nem como prova de quem é o titular de uma gravação.

A API não aceita links do Spotify. Cole-os nas ferramentas gratuitas deste site.

Exemplos

Consulta por código

Envie uma solicitação GET com isrc ou upc na string de consulta. São códigos públicos, então podem ir no endereço.

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 link

Links de lojas podem levar parâmetros de rastreamento, então envie-os em um corpo JSON com POST e nunca no endereço.

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"}'

Resposta

Cada resposta tem ok, version, data, sources, attribution e poweredBy. Um campo sem valor é 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)"
}

Limites

  • 30 solicitações por minuto e 1000 por dia para cada endereço.
  • As respostas podem ficar em cache por alguns minutos, e os dados por trás delas por até um dia.
  • Não é preciso chave. Os limites podem mudar, e o campo version informa qual esquema você recebe.

Erros

  • 400 invalid_request: o código está ausente, malformado ou não passa no dígito de controle.
  • 404 not_found: nada foi encontrado para este código.
  • 422 unsupported_link: o link não é um link do Apple Music.
  • 429 rate_limited: aguarde os segundos indicados no cabeçalho Retry-After.
  • 503 unavailable: uma fonte de dados está ocupada, então tente de novo em breve.

Atribuição

Mostre as fontes citadas em cada resposta e mantenha a linha Powered by WBBT. Um link para wbbt.net/tools/api é bem-vindo.

Perguntas

Preciso de uma chave de API?

Não. A API é aberta, não usa chave e é limitada por endereço. Se precisar de mais solicitações, escreva para [email protected].

Posso chamá-la de uma página da web?

Sim, as solicitações GET por código. Elas enviam cabeçalhos CORS abertos. Os links vão no corpo de um POST, então chame essa parte do seu próprio servidor.

Por que existe uma página permanente para cada código?

Cada resposta inclui um pageUrl, uma página pública em wbbt.net para aquele código. Use o link se quiser que as pessoas vejam todos os detalhes.

Todas as ferramentas grátis →

Vai lançar sua própria música?

Veja o que a WBBT oferece a artistas e selos independentes, ou envie sua música para nós.

Comece hojeEnviar música