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.

organization_id
string<uuid>

Optional. ID of an organization to own the resulting catalog instead of the calling account. Every member of that organization then sees it in their own Get Catalogs response. The caller must be a member of the organization; otherwise the request is rejected with 403. Credits are still spent by the calling account, and the searched artist is still linked to the caller's roster. Omit to own the catalog personally, which is the default.

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')