Tunebat APItunebat.com ↗

"""Walkthrough: Tunebat SDK — search tracks, get details, inspect audio features."""
from parse_apis.Tunebat_Music_Data_API import Tunebat, TrackNotFound

client = Tunebat()

# Search for tracks by keyword — limit= caps total items fetched.
for summary in client.tracks.search(query="Blinding Lights", limit=3):
    print(summary.name, summary.artist, summary.track_id)

# Drill down: take the first result and fetch full details.
first = client.tracks.search(query="Shape of You", limit=1).first()
if first:
    track = first.details()
    print(track.title, track.artist, track.bpm, track.key, track.camelot)
    print(track.features.energy, track.features.danceability, track.features.happiness)
    print(track.additional_info.album, track.additional_info.release_date)

# Use a track_id from a previous search result for direct lookup.
second = client.tracks.search(query="piano", limit=1).first()
if second:
    detail = client.tracks.get(track_id=second.track_id)
    print(detail.title, detail.artist, detail.duration)

# Typed error handling for a non-existent track.
try:
    client.tracks.get(track_id="INVALID_ID")
except TrackNotFound as exc:
    print(f"Track not found: {exc.track_id}")

print("exercised: tracks.search / TrackSummary.details / tracks.get / TrackNotFound")