---
title: "Viewers and share per country."
method: GET
path: "/2/vod/statistics/{subject}/countries"
tags: ["V3 > Statistics"]
---

# Viewers and share per country.

`GET /2/vod/statistics/{subject}/countries`

Retrieves the number of viewers and total share per country for the provided subject;
The share is based on all the countries for this subject, not just on the countries within the limit.
Therefore, the sum of the share for each country may not reach 1 (100%) if a limit is provided.

## Path parameters

- `subject` string, required

## Query parameters

- `from` string, nullable — <note><strong>Date</strong>: any accepted <a href="https://www.php.net/manual/fr/datetime.formats.date.php" target="_blank">PHP date format</a></note> <note><strong>Timestamp</strong>: a Timestamp</note> <note><strong>Time interval</strong>: a positive or negative interval with pattern: <pre>/\+|\-\d+[YyMdhims]/</pre> <table> <thead> <tr> <td>symbol</td> <td>description</td> </tr> </thead> <tbody> <tr> <td>Y|y</td> <td>Year</td> </tr> <tr> <td>M</td> <td>Month</td> </tr> <tr> <td>d</td> <td>Day</td> </tr> <tr> <td>h</td> <td>Hour</td> </tr> <tr> <td>i|m</td> <td>Minute</td> </tr> <tr> <td>s</td> <td>Second</td> </tr> </tbody> </table> </note>
- `to` string, nullable — <note><strong>Date</strong>: any accepted <a href="https://www.php.net/manual/fr/datetime.formats.date.php" target="_blank">PHP date format</a></note> <note><strong>Timestamp</strong>: a Timestamp</note> <note><strong>Time interval</strong>: a positive or negative interval with pattern: <pre>/\+|\-\d+[YyMdhims]/</pre> <table> <thead> <tr> <td>symbol</td> <td>description</td> </tr> </thead> <tbody> <tr> <td>Y|y</td> <td>Year</td> </tr> <tr> <td>M</td> <td>Month</td> </tr> <tr> <td>d</td> <td>Day</td> </tr> <tr> <td>h</td> <td>Hour</td> </tr> <tr> <td>i|m</td> <td>Minute</td> </tr> <tr> <td>s</td> <td>Second</td> </tr> </tbody> </table> </note>
- `top` integer, nullable — Limit the response size to the top N results.

## Response `200`

OK

- object
  - `result` 'success' | 'error' | 'asynchronous', required — Result of the HTTP request
  - `data` 1527df96Countryshareitem[]
    - `country_code` string, required — The country code of the Country share item
    - `viewers` integer, required — The number of viewers
    - `share` number, required — Share of the total value represented by this {Country share item}, expressed as a percentage (0–100).

---

[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-service-production.skmtc.workers.dev/v1/apis/infomaniak/api-reference-developer-tools/revisions/667aae28fec6/schema)