{"service": "songs-recognition-api", "routes": {"POST /recognize": "multipart file (repeat for batch), or raw audio/video body; ?full=1 returns one raw recognition", "GET /healthz": "local liveness; does not check upstream services", "GET /track/{id}": "track details", "GET /search?q=...&limit=5": "track search", "GET /artist/{id}?limit=10": "artist details and songs", "GET /lyrics?title=...&artist=...": "lyrics by name", "GET /lyrics/{key}": "lyrics by Shazam track id", "GET /top/world": "world chart", "GET /top/country/{cc}": "country chart", "GET /top/genre/{genre}": "genre chart", "GET /top/city/{cc}?city=...": "city chart"}, "limits": {"upload_bytes": 104857600, "media_seconds": 600.0, "slice_seconds": 10, "recognition_concurrency": 2, "decoder_concurrency": 4, "recognition_timeout_seconds": 100.0, "query_limit": "1..50"}, "notes": ["Ten-second samples are recommended; long scans may reach the request deadline.", "Scan responses retain unrecognized and error windows; matching songs are merged only across consecutive matched windows.", "Lyrics lookup may return a different recording version; synchronized lyrics need alignment before use."]}