TG Ads Documentation

Appearance

API Stats ​

Каждый запрос должен быть авторизован через Header:

http
Authorization: Bearer {apiToken}

{apiToken} можно получить на странице аккаунта

Статистика по странам ​

API Endpoint

http
https://api.tg-ads.co/api/v1/widget/stats/{widgetId}/?startDate=YYYY-MM-DD&endDate=YYYY-MM-DD&viewBy=country

Обязательные параметры: widgetId - ID виджета, можно получить на страницу виджетов в личном кабинете.
startDate - формат YYYY-MM-DD - пример - 2025-03-01
endDate - формат YYYY-MM-DD - пример - 2025-03-01

Валидный пример запроса:

http
https://api.tg-ads.co/api/v1/widget/stats/64352/?startDate=2025-03-01&endDate=2025-03-01&viewBy=country

Пример ответа:

json
[
  {
    "id": "US",
    "value": "US",
    "clicks": 0,
    "revenue": 0.0319,
    "impressions": 13,
    "ctr": 0,
    "cpm": 2.5
  },
  {
    "id": "PL",
    "value": "PL",
    "clicks": 3,
    "revenue": 0.0088,
    "impressions": 4,
    "ctr": 75,
    "cpm": 2.2
  },
]