Ücretsiz müzik sorgulama API'si

API ne döndürür

Sorgulama API'si, bir kayıt kodunun (ISRC), bir barkodun (UPC veya EAN) ya da bir Apple Music bağlantısının arkasındaki yayını döndürür: başlık, sanatçı, albüm, yayın tarihi, plak şirketi, telif satırı ve ilgili kodlar. Her yanıt veri kaynaklarını ve kısa bir atıf metnini listeler.

Sonuçlar açık veri tabanlarından gelir, bu yüzden yeni bir yayın ya da küçük bir katalog eksik olabilir. Sonucun olmaması kodun yanlış olduğunu kanıtlamaz.

Veriyi doğru kullanmak

Her yanıtla gelen kaynak adlarını gösterin ve Powered by WBBT satırını görünür tutun. Veriyi eksiksiz ya da bir kaydın sahibinin kanıtı gibi sunmayın.

Spotify bağlantıları API tarafından kabul edilmez. Onları bu sitedeki ücretsiz araçlara yapıştırın.

Koda göre sorgu

Sorgu dizesinde isrc veya upc ile bir GET isteği gönderin. Bunlar herkese açık kodlardır, adreste olmaları güvenlidir.

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);

Bağlantıya göre sorgu

Mağaza bağlantıları izleme parametreleri taşıyabilir, bu yüzden onları adrese değil, POST ile bir JSON gövdesinde gönderin.

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

Yanıt

Her yanıtta ok, version, data, sources, attribution ve poweredBy bulunur. Değeri olmayan alan null olur.

{
  "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)"
}

Sınırlar

• Her adres için dakikada 30 ve günde 1000 istek.
• Yanıtlar birkaç dakika, arkasındaki veri ise bir güne kadar önbellekte tutulabilir.
• Anahtar gerekmez. Sınırlar değişebilir, version alanı hangi şemayı aldığınızı söyler.

Hatalar

• 400 invalid_request: kod eksik, hatalı biçimli ya da kontrol hanesi tutmuyor.
• 404 not_found: bu kod için hiçbir şey bulunamadı.
• 422 unsupported_link: bağlantı bir Apple Music bağlantısı değil.
• 429 rate_limited: Retry-After başlığında yazan saniye kadar bekleyin.
• 503 unavailable: bir veri kaynağı meşgul, kısa süre sonra tekrar deneyin.

Atıf

Lütfen her yanıtta adı geçen kaynakları gösterin ve Powered by WBBT satırını koruyun. wbbt.net/tools/api adresine verilecek bir bağlantı memnuniyetle karşılanır.

Kendi müziğinizi mi yayınlıyorsunuz?

WBBT'nin bağımsız sanatçılara ve plak şirketlerine neler sunduğuna bakın ya da müziğinizi bize gönderin.