{"openapi":"3.1.0","info":{"title":"song-id API","version":"1.0.0","description":"Public music metadata only. Cache mode never resolves missing matches. No private account, history or playlist data."},"servers":[{"url":"https://song-id.com"}],"paths":{"/api/song":{"get":{"summary":"Lookup service links, identifiers, credits and sourced metadata","parameters":[{"name":"title","in":"query","required":true,"schema":{"type":"string"}},{"name":"artist","in":"query","required":true,"schema":{"type":"string"}},{"name":"mode","in":"query","required":false,"schema":{"type":"string","enum":["cache","resolve"],"default":"resolve"}},{"name":"services","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Public music facts and sourced observations"},"400":{"description":"Invalid query"},"429":{"description":"Rate limited"},"503":{"description":"Temporarily unavailable"}}}},"/api/catalog":{"get":{"summary":"Search saved songs","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Public music facts and sourced observations"},"400":{"description":"Invalid query"},"429":{"description":"Rate limited"},"503":{"description":"Temporarily unavailable"}}}},"/api/artist":{"get":{"summary":"Read artist catalog","parameters":[{"name":"artist","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Public music facts and sourced observations"},"400":{"description":"Invalid query"},"429":{"description":"Rate limited"},"503":{"description":"Temporarily unavailable"}}}},"/api/artist-recordings":{"get":{"summary":"Read paginated recordings","parameters":[{"name":"artist","in":"query","required":true,"schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Public music facts and sourced observations"},"400":{"description":"Invalid query"},"429":{"description":"Rate limited"},"503":{"description":"Temporarily unavailable"}}}},"/api/search":{"get":{"summary":"Search music","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Public music facts and sourced observations"},"400":{"description":"Invalid query"},"429":{"description":"Rate limited"},"503":{"description":"Temporarily unavailable"}}}}}}