Skip to main content
GET
/
api
/
catalogs
/
measurements
cURL
curl --request GET \
  --url https://api.recoupable.dev/api/catalogs/measurements \
  --header 'x-api-key: <api-key>'
{
  "measurements": [
    {
      "isrc": "<string>",
      "title": "<string>",
      "playcount": 123,
      "measured_at": "2023-11-07T05:31:56Z"
    }
  ],
  "valuation": {
    "low": 123,
    "mid": 123,
    "high": 123
  },
  "total_streams": 123,
  "catalog_age_years": 123,
  "error": "<string>"
}

Authorizations

x-api-key
string
header
required

Your Recoup API key. Learn more.

Query Parameters

catalogId
string<uuid>
required

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

Status of the request

Available options:
success,
error
measurements
object[]

One entry per catalog song that has at least one measurement: the newest capture per ISRC. Songs never measured are omitted.

valuation
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.

total_streams
integer

Sum of the latest play counts across all measured songs

catalog_age_years
integer

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
string

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