HTTP APIСтатистика

Доход и статистика

GET/api/v1/earnings

Получайте доход через API с тем же Bearer-токеном, что и для рекламы. Отдельный ключ статистики не нужен. Метод возвращает показы, клики и доход за период, с фильтром по площадке и разбивкой по дням. Для показов и дохода также есть разбивка по формату: image и text.

Авторизация

Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Параметры запроса

Поле	Тип	Описание
`platform_id`	string	Фильтр по одной площадке (plt_…). Без него учитываются все площадки паблишера, которому принадлежит API-ключ.
`days`	number	Целое число от 1 до 90. По умолчанию: 30. Текущие отчёты могут включать день перед period.from.

Пример

curl "https://sidekick-ads.com/api/v1/earnings?platform_id=plt_xxx&days=7" \
  -H "Authorization: Bearer sk_live_xxxxx"

Ответ

200 OK

{
  "publisher_id": 50,
  "scope": "platform",
  "platform": {
    "public_id": "plt_xxx",
    "name": "AI Chat Companion",
    "type": "telegram"
  },
  "period": {
    "from": "2026-05-08",
    "to": "2026-05-14",
    "days": 7
  },
  "total": {
    "impressions": 2561,
    "image_impressions": 320,
    "text_impressions": 2241,
    "clicks": 40,
    "ctr": 1.5619,
    "earnings_micro": 8195200,
    "earnings_usd": 8.1952,
    "image_earnings_micro": 1920000,
    "image_earnings_usd": 1.92,
    "text_earnings_micro": 6275200,
    "text_earnings_usd": 6.2752
  },
  "daily": [
    {
      "day": "2026-05-13",
      "impressions": 1200,
      "image_impressions": 0,
      "text_impressions": 1200,
      "clicks": 18,
      "earnings_micro": 3840000,
      "earnings_usd": 3.84,
      "image_earnings_micro": 0,
      "image_earnings_usd": 0,
      "text_earnings_micro": 3840000,
      "text_earnings_usd": 3.84
    },
    {
      "day": "2026-05-14",
      "impressions": 1361,
      "image_impressions": 320,
      "text_impressions": 1041,
      "clicks": 22,
      "earnings_micro": 4355200,
      "earnings_usd": 4.3552,
      "image_earnings_micro": 1920000,
      "image_earnings_usd": 1.92,
      "text_earnings_micro": 2435200,
      "text_earnings_usd": 2.4352
    }
  ]
}

earnings_micro — фактически начисленная сумма в микро-USD (1 USD = 1 000 000 микро). earnings_usd — та же сумма в удобном для чтения виде. image_* и text_* разделяют показы и доход по формату объявления. Изображения обычно приносят больше за показ. События, записанные до появления рекламы с изображениями, относятся к text. Сумма двух групп всегда равна общему итогу (image_impressions + text_impressions = impressions, image_earnings_micro + text_earnings_micro = earnings_micro). Массив daily содержит только дни с активностью; дни без событий пропускаются. Если platform_id не передан, scope — "all" и platform — null.

Ответы с ошибкой

Статус	Значение
`400`	Неверный days (нужно целое число 1–90) или некорректный platform_id (должен начинаться с plt_).
`401`	API-ключ отсутствует или недействителен.
`404`	platform_id не существует или не принадлежит этому аккаунту.