> For the complete documentation index, see [llms.txt](https://docs.umg.team/main/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.umg.team/main/ussp.io/api-statistiki-dlya-pablishera.md).

# API статистики для паблишера

API статистики для паблишеров платформы uSSP, предоставляет альтернативный доступ к статистике

<mark style="color:orange;">Важно!</mark>

<mark style="color:orange;">Получить ключ можно у поддержки в Telagram: @UMG\_support или по email: <supply@umg.team></mark>

### Шаблон инструкция (вместо **XXX** подставить ключ при выдаче инструкции) <a href="#id-utraff-apistatistikidlyapablishera-shabloninstrukciya-vmestoxxxpodstavitklyuchprivydacheinstrukci" id="id-utraff-apistatistikidlyapablishera-shabloninstrukciya-vmestoxxxpodstavitklyuchprivydacheinstrukci"></a>

Ваш ключ **XXX**&#x20;

Для получения статистики по вашим площадкам вам нужно отправить GET запрос с заголовком Authorization: ApiKey **XXX**

Пример запроса:[ `https://api.ussp.io/open_api/webmaster/report/host/?host_id=1&start=2022-09-14&end=2022-09-14`](https://api.ussp.io/open_api/webmaster/report/host/?host_id=8\&start=2019-03-10\&end=2019-03-10)

Дополнительная информация:

* host\_id можно получить из таблицы на странице [`webmaster.ussp.io/hosts`](https://webmaster.ussp.io/hosts)
* если host\_id не указан, выведутся все площадки&#x20;
* без start/end выведется текущий день
* максимальный разрешенный интервал - 1 месяц&#x20;
* лимит отчетов: 6 за минуту

### Примеры запросов и ответов <a href="#id-utraff-apistatistikidlyapablishera-primeryzaprosoviotvetov" id="id-utraff-apistatistikidlyapablishera-primeryzaprosoviotvetov"></a>

1. Пример запроса для host\_id = 1 за период 3 августа 2024: <https://api.ussp.io/open_api/webmaster/report/host/?host_id=1&start=2024-03-08&end=2024-03-08>
2. Пример запроса где host\_id не указан за период 03 август 2024: <https://api.ussp.io/open_api/webmaster/report/host/?start=2024-03-08&end=2024-03-08>

**Обозначения параметров в ответе:**

* host\_url – Название в карточке площадки
* loads – Загрузки на площадке &#x20;
* bids – Показы на площадке
* cost – Исходящая абсолютная &#x20;
* ctr – CTR на площадке
* url – URL площадки из карточки площадки, так же выводиться в кабинете паблишера на странице [`webmaster.ussp.io/hosts`](https://webmaster.ussp.io/hosts)
* id  – id площадки из кабинета паблишера из таблицы на странице [`webmaster.ussp.io/hosts`](https://webmaster.ussp.io/hosts)

<br>

```



```