Flexible input handling
Resolve the same track from a Spotify share URL, a canonical track ID, or a plain text query.
Overview
Spotify resolution tool, canvas inspection, and operational reference.
The compact workspace for Spotify canvas and track resolution.
Spotycovs is a technical tool designed to resolve Spotify URLs, IDs, and queries into structured metadata and canvas-ready assets.
Canvas-aware output
Track metadata and canvas media are separated clearly so no-canvas responses remain useful instead of looking broken.
Inspection-ready interface
Open the returned Spotify track, inspect raw JSON, copy track IDs, and follow the generated API URLs from the same result surface.
Search-first fallback
Search matching is score-filtered to avoid weak or stale-like results and returns only confident candidates for the current query.
Operational visibility
Health checks, rate-limit state, and missing dependency signals are separated from product copy so trust comes from runtime behavior.
Contract-first docs
Routes, parameters, response fields, and practical failure modes are grouped into a readable developer surface instead of scattered notes.
Next step
Ready to resolve?
Start by resolving a track on the live surface, or jump straight into the technical documentation.
A compact team layer behind the interface.
The people here shape how the tool looks, feels, and works so the workspace stays clear, fast, and trustworthy.
History
How It Started
Spotycovs started as a small tool created out of boredom, used initially only on our own websites. Over time, we kept improving the resolver flow, response quality, and overall interface.
After it became stable and genuinely useful in day-to-day usage, we decided to make it public and shape it into the form you see now.
Team
Contributors
lastanswtcf
Core contributor focused on backend API architecture and full-stack website development, ensuring system reliability and high-performance execution.
ilovebee
Key creative force driving the interface concept and website vision, shaping the aesthetic and functional direction of the workspace.
noy
Specialized backend contributor assisting with server-side logic, API optimization, and core infrastructure maintenance.
None provided.
Support
Donate
Support our work if you find Spotycovs useful. Every contribution helps us keep improving the tool.
LTC Address
LYr5ypcGNUfXYF5As7JapdciKNxEHm4r1t
Legal & Tool Information
Spotycovs functions as a technical bridge for Spotify media inspection. The platform is designed for read-only resolution workflows and metadata analysis, with a strict boundary between runtime infrastructure and user credentials.
Operational architecture
The utility uses an internal server-side authentication layer (pre-configured service sessions) to resolve track metadata and retrieve canvas media assets. All requests are processed as technical lookup operations.
Credential boundary
Spotycovs does not request, store, or process personal Spotify passwords, login tokens, or account credentials from visitors. Runtime operations remain isolated in backend service context.
Data scope
The tool processes Spotify identifiers such as track URLs, IDs, and textual queries to produce structured API output for inspection, debugging, and metadata/canvas verification.
No User Credentials
No passwords and no personal login sessions from visitors.
Server-Side Isolation
Resolution and media checks run in backend service context.
Technical Inspection Only
Built for deterministic inspection and verification workflows.
Identifier-Level Processing
Only track URLs, IDs, and text queries are processed for output.
Workspace Updates
Latest platform changes, release notes, and backend behavior upgrades for resolver quality and API consistency.
RELEASE LOG
Update V 1.3
Tap to reveal changes
V 1.3
Search Accuracy + New Data Endpoints
Accuracy upgrades for resolver output plus major API surface expansion for lyrics and artist flows.
- Search quality: weak track matches are filtered out to avoid stale-looking or irrelevant results.
- New routes: added
/api/lyricsand/api/artistwith detailed payloads. - Error model: API errors now include explicit machine-friendly codes.
Resolver
Resolve Spotify inputs into deterministic metadata, canvas payloads, and follow-up API routes for inspection workflows.
Import
Use a public Spotify track URL when you already have the shared link.
Useful when testing the search resolver or when only the song title is known.
Best option for deterministic lookups when the canonical Spotify ID is available.
Provide at least one of track query, track ID, or track URL to fetch lyrics.
Use query, ID, or URL. Limit controls related payload size.
API Docs
Contract-first reference for Spotycovs routes: request parameters, response fields, and practical runtime behavior.
API docs
API Overview
Use this as a contract-first reference for request parameters, response fields, and production-safe usage patterns.
Format
JSON responses
All routes return structured JSON.
Methods
GET endpoints
All resolver routes use query parameters and return JSON.
Debug
debug=1
Available on supported routes for extra details.
Errors
error + code
Failures return explicit error messages and stable machine-friendly codes.
Getting Started
Quick Start
Fastest way to integrate: call one route, inspect request.apiUrl, then chain into adjacent routes.
Integration Notes
Base URL/api/* on the same domain as your deployment.Typical chain/api/resolve → /api/canvas for deterministic media checks.Debug modeAdd debug=1 where supported for additional trace context.Example Calls
GET /api/resolve?url=https://open.spotify.com/track/...Resolve URL into canonical track identity.GET /api/canvas?id=3zlJIBfHmFMjvT8TtGf1BWRequest canvas/media payload for a known ID.GET /api/lyrics?track=Summertime%20Sadness&artist=Lana%20Del%20ReyFetch lyrics using text-first resolution.Reference
Conventions
Shared response and error rules that apply across endpoints.
Success Shape
successBoolean success signal for machine checks.sourceUpstream resolver/source used for this payload.request.apiUrlCanonical route form you can reuse directly.Error Shape
success: falseReturned on all handled endpoint failures.errorHuman-readable explanation for UI rendering.codeStable machine-friendly token (e.g. spotify_rate_limited).
GET
/api/resolve
Resolve URL/ID/query inputs into a stable track identity before calling metadata-heavy routes.
Request Parameters
idSpotify track ID.urlSpotify track URL or URI.trackText query used for search resolution.results=1Include candidate matches when search is involved.debug=1Include auth and resolver debug information.Response Fields
trackIdThe resolved Spotify track ID.trackTrack metadata object when available.resolutionResolver details such as source and strategy.requestPrebuilt follow-up API URLs.GET /api/resolve?url=https://open.spotify.com/track/3zlJIBfHmFMjvT8TtGf1BW
GET
/api/canvas
Fetch canvas availability and media payloads for a resolved track identity.
Request Parameters
idSpotify track ID.urlSpotify track URL or URI.trackTrack search query.results=1Include additional resolution context.debug=1Include trace and auth diagnostics.Response Fields
hasCanvasWhether Spotify returned canvas media.canvasesCanvas payload list.trackResolved track metadata when available.request.apiUrlCanonical API URL for the request.GET /api/canvas?id=3zlJIBfHmFMjvT8TtGf1BW
GET
/api/search
Run search-first matching and return confident candidates plus the best track match.
Request Parameters
trackRequired text query.debug=1Include trace and auth state details.Response Fields
trackIdBest match Spotify track ID.matchedTrackResolved track title.matchedArtistResolved artist.resultsCandidate result list.GET /api/search?track=Artist%20-%20Track%20Name
GET
/api/track
Fetch canonical track metadata directly when you already know the Spotify track ID.
Request Parameters
idRequired Spotify track ID.Response Fields
trackIdThe normalized Spotify track ID.trackTrack metadata object.GET /api/track?id=3zlJIBfHmFMjvT8TtGf1BW
GET
/api/lyrics
Return lyrics lines and optional Spotify color-lyrics payload when auth context allows it.
Request Parameters
idSpotify track ID.urlSpotify track URL or URI.trackTrack name query.artistOptional artist name for better resolution.Response Fields
trackIdResolved Spotify track ID.lyrics.linesLyrics lines array.colorLyricsSpotify color lyrics payload when available.resolutionTrack resolution details.GET /api/lyrics?track=Summertime%20Sadness&artist=Lana%20Del%20Rey
GET
/api/artist
Return normalized artist profile + related top tracks, albums, and artists.
Request Parameters
idSpotify artist ID.urlSpotify artist URL or URI.queryArtist text query.limitRelated surface size (max 25).raw=1Include raw upstream artist payload for deep debugging.Response Fields
artistIdResolved artist ID.summaryNormalized profile, stats, genres, and curated lists.related.topTracksTop tracks normalized for UI/API consumers.related.albumsPopular releases/albums normalized for display.related.artistsRelated artists list with normalized identity fields.GET /api/artist?query=The%20WeekndRuntime Health
Live operational status for Spotify connectivity, canvas auth checks, and recent API request activity.
Loading health data
The dashboard will render after the API responds.