---
title: "Get players"
method: GET
path: "/1/radios/{radio_product}/stats/players"
tags: ["Stats > Radio Products"]
---

# Get players

`GET /1/radios/{radio_product}/stats/players`

## Request

- Base URL: `https://api.infomaniak.com`
- URL: `https://api.infomaniak.com/1/radios/{radio_product}/stats/players`
- Auth: HTTP bearer

This endpoint allows you to retrieve players stats.

## Path parameters

- `radio_product` integer, required

## Query parameters

- `from` string, required: Specify the starting date to get stats
- `scope_by` 'day' | 'month' | 'week' | 'year': Specifies the time period over which to aggregate and retrieve stats
- `station_ids` string: List of station ids for get stats
- `to` string, required: Specify the ending date to get stats

## Response `200`

OK

- object
  - `result` 'success' | 'error' | 'asynchronous', required: Result of the HTTP request
  - `data` 0cc1b8a9StatPlayer[]
    - `player` string, required: The player name for this stat
    - `stats` 0cc1b8a9StatPlayerStats[], required
      - `date` string, required: The date for this stat
      - `listeners` integer, required: The number of listeners

## Other responses

- `404`: Not Found

---

[API](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools.md) - [All operations](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools/llms.txt) - [OpenAPI document](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools/revisions/96ca7c8a0545?raw)