{"name":"Linked API","version":"1.0.0","description":"Music link unification API. Paste a link from any supported platform, get a universal 'Linked' URL that works everywhere.","baseUrl":"/api","endpoints":[{"method":"POST","path":"/api/resolve","description":"Resolve a music URL from any supported platform into a universal Linked URL with cross-platform links.","parameters":[{"name":"url","in":"body","type":"string","required":true,"description":"Music URL from a supported platform."}],"example":{"request":{"url":"https://open.spotify.com/track/4cOdK2wGEL8SetjwfNnPKc"},"response":{"entity":"{ name, artist, image, year, links, tracks }","source":"{ platform, type, platformId, url }","linkedId":"sp-n5glkt","linkedUrl":"/song/sp-n5glkt"}}},{"method":"GET","path":"/api/entity/:type/:id","description":"Resolve a Linked ID back to full metadata with cross-platform links.","parameters":[{"name":"type","in":"path","type":"string","required":true,"description":"Entity type: 'song', 'album', or 'artist'."},{"name":"id","in":"path","type":"string","required":true,"description":"The Linked ID (e.g. 'sp-n5glkt')."}]},{"method":"GET","path":"/api/oembed","description":"oEmbed endpoint for rich previews (Twitter, Discord, Slack). Returns embeddable HTML with thumbnail and metadata.","parameters":[{"name":"url","in":"query","type":"string","required":true,"description":"Music URL from a supported platform."},{"name":"maxwidth","in":"query","type":"number","required":false,"description":"Max embed width in pixels (200-1200, default 600)."},{"name":"theme","in":"query","type":"string","required":false,"description":"'light' (default) or 'dark'."}],"spec":"https://oembed.com/"},{"method":"GET","path":"/api/search","description":"Search for tracks, albums, or artists across platforms via Deezer.","parameters":[{"name":"q","in":"query","type":"string","required":true,"description":"Search query (e.g. 'Bohemian Rhapsody')."},{"name":"type","in":"query","type":"string","required":false,"description":"'track' (default), 'album', or 'artist'."},{"name":"limit","in":"query","type":"number","required":false,"description":"Number of results (1-25, default 10)."}]},{"method":"GET","path":"/api/health","description":"Health check for the API and all downstream music services. Returns status and latency for each.","parameters":[]},{"method":"GET","path":"/api/help","description":"This endpoint. Returns API documentation and roadmap.","parameters":[]}],"supportedPlatforms":["Spotify","Apple Music","Deezer","Tidal","YouTube","Amazon Music"],"supportedEntityTypes":["song","album","artist"],"rateLimit":"None currently. Fair use appreciated.","cors":"Enabled for all origins.","roadmap":["Multi-platform search (not just Deezer)"]}