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 a catalog from the resulting snapshot (idempotent - see Create catalog), and returns the catalog with its estimated value band. The catalog is owned by the calling account unless organization_id names one of the caller’s organizations to own it instead, in which case every member of that organization sees it. The calling account is always taken from the credentials, never the body, and it is the account whose credits are spent. 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). Each run also persists a row in the catalog’s valuation history, readable via Get Catalog Valuations.
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.
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 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')
