getstats

Back to API reference

Get statistics, same data as seen in Listeners > Statistics area.

Request

GET /api/getstats/StationID?key=APIKey&from=YYYY-MM-DD&to=YYYY-MM-DD

Example request

https://c1.radioboss.fm/api/getstats/92?key=A1B2C3&from=2026-01-01&to=2026-01-31

Example of returned data (JSON)

{
  "countries": [
    {
      "cnt": 412,
      "country": "United States",
      "country_iso": "us"
    },
    {
      "cnt": 187,
      "country": "Germany",
      "country_iso": "de"
    },
    {
      "cnt": 96,
      "country": "Brazil",
      "country_iso": "br"
    }
  ],
  "countries_tlh": [
    {
      "country": "United States",
      "country_iso": "us",
      "tlh": 318
    },
    {
      "country": "Germany",
      "country_iso": "de",
      "tlh": 142
    },
    {
      "country": "Brazil",
      "country_iso": "br",
      "tlh": 71
    }
  ],
  "unique": [
    {
      "uniq": 295,
      "country": "United States",
      "country_iso": "us"
    },
    {
      "uniq": 134,
      "country": "Germany",
      "country_iso": "de"
    },
    {
      "uniq": 78,
      "country": "Brazil",
      "country_iso": "br"
    }
  ],
  "days": [
    {
      "date": "2026-05-14",
      "cnt": 221,
      "cnt_unique": 168
    },
    {
      "date": "2026-05-15",
      "cnt": 248,
      "cnt_unique": 181
    },
    {
      "date": "2026-05-16",
      "cnt": 226,
      "cnt_unique": 158
    }
  ],
  "total_sessions": 695,
  "total_unique": 507,
  "total_tlh": 531
}