Run Valuation
Generate a catalog from a Spotify artist in one call. Resolves the artist’s releases, captures current Spotify play counts (spending the account’s credits), materializes an account-owned catalog from the resulting snapshot (idempotent - see Create catalog), and returns the catalog with its estimated value band. The owning account is taken from the credentials, never the body. The searched artist is also linked to the caller’s roster (so a funnel signup lands with a populated GET /api/artists it can confirm); when the catalog’s songs already resolve a canonical artist that one is used, otherwise the searched Spotify artist is linked directly. Synchronous: the request waits for the capture to land (typically under two minutes).
Authorizations
Your Recoup API key. Learn more.
Body
The Spotify artist to value.
The Spotify artist id to value (e.g. from a Spotify artist search). The endpoint resolves this artist's releases, measures them, and builds the catalog.
Response
Catalog created (or idempotently re-fetched) with its estimated value band.
Result of a valuation run: the materialized catalog and its estimated value band.
Status of the request
success, error A catalog with its metadata
Estimated catalog value in USD, derived at read time from the latest measurements - the same model as the recoupable.dev valuation card. Annual run-rate = lifetime streams / catalog age (lifetime-average proxy), converted to net label share (all-DSP gross-up 1.25/1.4/1.6, 15% distribution fee, 25% royalty share, $0.0035 per Spotify stream) and multiplied by a 10x/13x/16x master-catalog market multiple.
Number of tracks with a captured play count that were materialized into the catalog.
Error message (only present if status is 'error')
