Get Catalog Measurements
Get the latest play counts and a derived valuation band for a catalog. Measurements are captured by Create measurement job runs; the band is computed at read time from the latest capture per song.
Authorizations
Your Recoup API key. Learn more.
Query Parameters
The unique identifier of the catalog to read measurements for. The catalog must belong to the authenticated account.
Response
Latest per-song measurements and the derived valuation band
Latest per-song play counts for a catalog plus the valuation band derived from them
Status of the request
success, error One entry per catalog song that has at least one measurement: the newest capture per ISRC. Songs never measured are omitted.
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.
Sum of the latest play counts across all measured songs
Catalog age in years used for the annual run-rate: from the earliest Spotify release date of the source run's albums, minimum 1; defaults to 5 when no release date is resolvable.
Error message (only present if status is 'error')
