Metal Archives APImetal-archives.com ↗

"""Metal Archives SDK — search bands, explore discographies, and discover similar artists."""
from parse_apis.metal_archives_api import MetalArchives, DiscographyTab, NotFoundError_

client = MetalArchives()

# Search for bands by name — limit= caps total items fetched.
for band in client.bands.search(query="Metallica", limit=3):
    print(band.name, band.genre, band.country)

# Drill into the first result's full details.
band = client.bands.search(query="Slayer", limit=1).first()
if band:
    detail = band.details()
    print(detail.name, detail.status, detail.formed_in, detail.years_active)

    # Walk discography filtered to main releases.
    for release in detail.discography(tab=DiscographyTab.MAIN, limit=5):
        print(release.name, release.year, release.type)

    # Get album details from the first release.
    first_release = detail.discography(tab=DiscographyTab.MAIN, limit=1).first()
    if first_release:
        album = first_release.details()
        print(album.name, album.release_date, album.label)
        for track in album.tracklist:
            print(track.number, track.title, track.duration)

    # Explore band members and drill into an artist.
    lineup = detail.members()
    for member in lineup.current:
        print(member.name, member.role)

    # Fetch similar bands.
    for rec in detail.recommendations(limit=5):
        print(rec.name, rec.genre, rec.score)

# Typed error handling for a non-existent band.
try:
    client.bands.get(band_id="9999999999")
except NotFoundError_ as exc:
    print(f"Band not found: {exc}")

# Fetch a label and explore its roster.
label = client.labels.get(label_id="2")
print(label.name, label.country, label.founded)
for roster_band in label.roster.list(limit=5):
    print(roster_band.name, roster_band.genre)

print("exercised: bands.search / bands.get / discography / members / recommendations / albums.get / labels.get / roster.list")