Streams

Airplay report

Airplay/spin report over a date range, across all your streams or one via stream_id. The report is grouped by stream: each streams[] entry carries its own per-track summary of play counts plus a timestamped detail play-by-play log, each row carrying its ISRC. Plays are de-duplicated per airing: one airing counts once, not once per recognition window. JSON only.

Requires a paid plan: the free tier returns 403 for this endpoint.

get/v1/streams/report

Request

  • Base URL: https://api.sonovault.now
  • URL: https://api.sonovault.now/v1/streams/report
  • Auth: API key in header x-api-key

Query parameters

fromstring required

Start of the window (inclusive), ISO date, e.g. 2026-06-01.

untilstring required

End of the window (exclusive), ISO date. The window must be 92 days or less.

stream_idstring

Limit the report to one stream id. Omit for an account-wide report across all your streams.

Response

Successful response

Changes

No recorded changes to this operation across all 1 revision of this API.