Sonusly API Docs

Sonusly publishes a small public API for track and artist discovery, plus discovery metadata that helps automated clients find docs, machine-readable descriptions, auth preferences, and agent-specific resources.

Public API

GET /spotify-api/search?q={query}&limit={1-10}

Search Sonusly’s public track and artist endpoint.

GET /spotify-api/tracks/{trackId}

Return normalized track details for a Spotify track.

GET /spotify-api/artists/{artistId}

Return normalized profile data for a Spotify artist.

GET /spotify-api/artists/{artistId}/albums?limit={1-50}

Return recent albums for a Spotify artist.

GET /api/health

Simple health check for monitoring and service discovery.

Machine Discovery

API catalog: https://www.sonusly.com/.well-known/api-catalog

OpenAPI description: https://www.sonusly.com/openapi.json

Agent skills index: https://www.sonusly.com/.well-known/agent-skills/index.json

MCP server card: https://www.sonusly.com/.well-known/mcp/server-card.json

MCP endpoint (Streamable HTTP JSON-RPC): https://www.sonusly.com/mcp

Service health: https://www.sonusly.com/api/health

Authentication Discovery

Protected resource metadata: https://www.sonusly.com/.well-known/oauth-protected-resource

OAuth authorization server metadata: https://www.sonusly.com/.well-known/oauth-authorization-server

OpenID configuration: https://www.sonusly.com/.well-known/openid-configuration

Backing auth issuer: https://zysybbrdvmsprmzhuvki.supabase.co/auth/v1

Notes for Agents

HTML pages support markdown negotiation. Send Accept: text/markdown to receive a markdown representation with Content-Type: text/markdown.

Primary HTML responses also advertise the API catalog, docs, OpenAPI description, health endpoint, skills index, and MCP server card via RFC 8288 Link headers.

The standalone MCP endpoint supports JSON-RPC over HTTP POST, including initialize, tools/list, tools/call, resources/list, and resources/read.

Content Signals preferences are published in /robots.txt and on agent-facing responses.