song-id / api

music data & links.

Public music facts. No login needed. Private playlists and history are never returned.

Song lookup

GET /api/song?title=Lonely&artist=Speaker+Knockerz&mode=cache

try cached lookup ↗

mode=cache reads saved results only. mode=resolve checks missing matches. Optional services=spotify,music,youtube,soundcloud,bandcamp.

Returns song identity, verified service links, per-service status, source-labelled facts, aggregated identifiers, credits, complete metadata observations, saved SongData references and cache/completeness flags. Unknown fields stay absent; source observations may describe different editions.

Catalogs

• GET /api/catalog?q=… / saved songs, up to 50
• GET /api/artist?artist=… / artist slug, albums and songs
• GET /api/artist-recordings?artist=…&cursor=… / paginated EverySong recordings
• GET /api/search?q=… / artist, song or supported music URL search

Tracked links

POST /api/v1/link / explicitly create a public song short link. GET /api/v1/link?code=… / aggregate activity. Creating links never publishes a playlist.

Versioned /api/v1/… routes remain supported. Song lookups allow browser CORS. Rate limits return 429; retry with backoff and cache results in your app.

OpenAPI schema ↗