Docs/Models

StatsRow

object

One group’s figures: current totals, the prior window, and an optional time series.

A single row of a stats response. group is {} when ungrouped; otherwise it carries the dimension values requested via group_by. content is a hosting item ID (the per-episode breakdown). The payments-only dimensions are action and supporter; the downloads-only dimensions are country, kind and platform. previous is the preceding window of equal length (zeroed when start is absent). buckets is present only when a bucket was requested.

Fields

groupobjectrequired

The dimension values for this row; {} when ungrouped.

contentstringoptional

Hosting item ID (per-episode breakdown).

countrystring | nulloptional

ISO 3166 country code (downloads-only dimension).

kindstring | nulloptional

Media kind: AUDIO or VIDEO (downloads-only dimension).

platformstring | nulloptional

Listener device / platform (downloads-only dimension).

appstring | nulloptional

Podcast client app.

actionstring | nulloptional

Payment action (payments-only dimension).

supporterstring | nulloptional

Supporter ID (payments-only dimension).

totalStatsMetricrequired

Current-window totals.

previousStatsMetricrequired

The preceding window of equal length; zeroed when start is absent.

bucketsStatsBucket[]optional

Time series; present only when bucket was requested.

Example
{
  "group": {},
  "total": {
    "downloads": 1240,
    "revenue_usd": 32.5,
    "revenue_satoshis": 48210,
    "supporters": 18
  },
  "previous": {
    "downloads": 980,
    "revenue_usd": 24,
    "revenue_satoshis": 35600,
    "supporters": 14
  }
}