Skip to main content
POST
Run valuation

Authorizations

x-api-key
string
header
required

Your Recoup API key. Learn more.

Body

application/json

The Spotify artist to value.

spotify_artist_id
string
required

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
enum<string>

Status of the request

Available options:
success,
error
catalog
object

A catalog with its metadata

band
object

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.

songs_measured
integer

Number of tracks with a captured play count that were materialized into the catalog.

error
string

Error message (only present if status is 'error')