Быстрый старт

1. Создайте ключ. Откройте Настройки → API & MCP и нажмите Создать API-ключ. Задайте название и срок действия.

   Осторожно

   Полностью ключ показывается один раз. Сохраните его в менеджере паролей или в переменных окружения.

2. Проверьте ключ. В ответе будут ваш тариф и остаток просмотров.

   curl https://app.gamler.io/api/v1/me \
     -H "Authorization: Bearer $GAMLER_KEY"

3. Найдите креативы.

   cURL

   curl "https://app.gamler.io/api/v1/creatives?countries=BR,MX&formats=video&sort=reach&per_page=24" \
     -H "Authorization: Bearer $GAMLER_KEY"

   Python

   import os, requests
   
   r = requests.get(
       "https://app.gamler.io/api/v1/creatives",
       headers={"Authorization": f"Bearer {os.environ['GAMLER_KEY']}"},
       params={"countries": "BR,MX", "formats": "video", "sort": "reach", "per_page": 24},
   )
   body = r.json()
   for card in body["data"]:
       print(card["uuid"], card["max_reach"])
   print("Осталось просмотров:", body["usage"]["views_remaining"])

   JavaScript

   const url = new URL("https://app.gamler.io/api/v1/creatives");
   url.search = new URLSearchParams({ countries: "BR,MX", formats: "video", sort: "reach", per_page: 24 });
   
   const res = await fetch(url, { headers: { Authorization: `Bearer ${process.env.GAMLER_KEY}` } });
   const { data, usage } = await res.json();

   PHP

   $ch = curl_init('https://app.gamler.io/api/v1/creatives?' . http_build_query([
       'countries' => 'BR,MX', 'formats' => 'video', 'sort' => 'reach', 'per_page' => 24,
   ]));
   curl_setopt_array($ch, [
       CURLOPT_RETURNTRANSFER => true,
       CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('GAMLER_KEY')],
   ]);
   $body = json_decode(curl_exec($ch), true);

4. Откройте карточку. Детали креатива бесплатны и не тратят просмотры.

   curl https://app.gamler.io/api/v1/creatives/UUID \
     -H "Authorization: Bearer $GAMLER_KEY"

Формат ответа

Успешный ответ всегда содержит data. Списки добавляют meta с пагинацией, а платные маршруты добавляют usage с остатком просмотров.

{
  "data": [{ "uuid": "b2ff67af-…", "format": "video", "countries": "BR,PT", "max_reach": 9114 }],
  "meta": { "total": 11790, "page": 1, "per_page": 24, "total_pages": 492, "views_charged": 3, "page_cached": false },
  "usage": { "plan": "Pro", "unlimited": false, "views_remaining": 4817, "period_end": "2026-11-02" }
}

Ключи в ответах записаны в snake_case.