Skip to main content
GET
Read catalog playcount history and period comparisons

Authorizations

x-api-key
string
header
required

Your Recoup API key. Learn more.

Path Parameters

catalogId
string<uuid>
required

Catalog owned by the authenticated account or an organization it currently belongs to.

Query Parameters

since
string<date>
required

Current UTC observation-period start. Previous period immediately precedes it. Boundaries use the latest observation on that date, not midnight stream totals.

days
integer
required

Equal length of both periods. Every UTC observation day through the final boundary must be finished and captured.

Required range: 1 <= x <= 31
page
integer
default:1
Required range: 1 <= x <= 1000000
limit
integer
default:25
Required range: 1 <= x <= 25

Response

Saved observations and page-scoped comparison coverage

status
enum<string>
Available options:
success
catalog_id
string<uuid>
platform
enum<string>
Available options:
spotify
metric
enum<string>
Available options:
platform_displayed_play_count
data_source
enum<string>
Available options:
apify_spotify_playcount
semantics
string
source_timestamp_available
enum<boolean>
Available options:
false
provider_identity_available
enum<boolean>
Available options:
false
comparison_quality
enum<string>
Available options:
legacy_recording_series_identity_unverified
missing_observation_reason_available
enum<boolean>
Available options:
false
collection_enabled
enum<boolean>
Available options:
false
periods
object
pagination
object
summary_scope
enum<string>
Available options:
page
comparable_recordings
integer
recordings
object[]