Amazon APImusic.amazon.com ↗

"""Walkthrough: Amazon Music SDK — bounded, re-runnable; every call capped."""
from parse_apis.music_amazon_com_api import AmazonMusic, SearchType, InputRequired

client = AmazonMusic()

# Search across the catalog — typed field access, limit caps total items.
for result in client.search_results.search(query="Taylor Swift", limit=3):
    print(result.name, result.type, result.url)

# Filter by type to get only tracks.
track = client.search_results.search(query="Drake", type=SearchType.TRACKS, limit=1).first()
if track:
    print(track.name, track.artists, track.image_url)

# Fetch full artist details by ID from a search result.
artist_hit = client.search_results.search(query="Adele", type=SearchType.ARTISTS, limit=1).first()
if artist_hit:
    try:
        artist = client.artists.get(artist_id=artist_hit.id)
        print(artist.name, artist.followers)
        for t in artist.top_tracks[:3]:
            print(" ", t.name, t.image_url)
    except InputRequired as e:
        print("input error:", e)

# Fetch album details.
album_hit = client.search_results.search(query="Midnights", type=SearchType.ALBUMS, limit=1).first()
if album_hit:
    album = client.albums.get(album_id=album_hit.id)
    print(album.name, album.artists, album.release_date)
    for trk in album.tracklist[:3]:
        print(" ", trk.track_number, trk.name)

# Browse upcoming releases by label.
for release in client.upcoming_releases.list(label_or_distributor="Republic Records", limit=3):
    print(release.name, release.artists, release.type)

print("exercised: search_results.search, artists.get, albums.get, upcoming_releases.list")