REST API аналитики сайтов в KinMetric: как выгрузить метрики через JSON

Открываешь утром Метрику, а там — пустота

Знакомая картина: понедельник, 10 утра, ты заходишь в аккаунт аналитики, чтобы глянуть статистику за выходные, а система показывает ноль. Или — хуже — какие-то странные цифры, которые не сходятся с твоими логами сервера. Ты начинаешь проверять код счётчика, потом лезешь в настройки фильтров, потом перепроверяешь UTM-метки. Проходит час, а ты так и не понял, что происходит.

А теперь представь другой сценарий. Ты просто дёргаешь API, получаешь сырые данные в JSON, закидываешь их в свой Google Data Studio (или Looker Studio) и видишь картину целиком за две минуты. Никаких посредников, никаких “возможно, данные ещё обрабатываются”. Только факты.

Именно для таких случаев в KinMetric есть REST API — простой способ выгружать все метрики сайта напрямую, без лишних интерфейсов и задержек.

Что такое REST API в KinMetric и зачем оно нужно разработчику

По сути, это прямой канал связи между твоими скриптами, дашбордами или CRM и сервером аналитики KinMetric. Ты отправляешь GET-запрос на нужный эндпоинт, передаёшь ключ авторизации — и получаешь структурированные данные в формате JSON. Никаких графиков, никаких кнопок — только чистые цифры.

Для кого это особенно полезно:

Разработчикам, которые строят свои системы мониторинга.

Маркетологам, которые хотят кастомные отчёты с данными из нескольких источников.

Владельцам сайтов, которые устали кликать по десятку вкладок, чтобы понять динамику.

С помощью этого API ты можешь собирать информацию о посещениях, просмотрах страниц, источниках трафика, географии пользователей и даже данные в реальном времени. И всё это — через один интерфейс.

Как это работает технически: ключи, эндпоинты и лимиты

Давай разберём механику. Всё начинается с создания ключа доступа.

Шаг 1: Создаём именованный ключ

Заходишь в дашборд KinMetric, находишь раздел API. Там ты можешь создать ключ — дать ему имя (например, “Для дашборда отдела маркетинга” или “Тестовый скрипт”). Ключ хранится в базе данных в зашифрованном виде, так что можно не бояться утечек.

Шаг 2: Используем эндпоинты

Теперь у тебя есть ключ. Дальше ты обращаешься к одному из эндпоинтов. Вот список основных:

/api/v1/sites — получить список всех твоих сайтов.

/sites/{id}/summary — сводка по конкретному сайту.

/visitors — данные по посетителям.

/top-pages — самые популярные страницы.

/top-sources — лучшие источники трафика.

/top-countries — география аудитории.

/realtime — данные в реальном времени (онлайн-посетители).

Шаг 3: Авторизация и лимиты

В заголовке каждого запроса ты передаёшь Authorization: Bearer YOUR_KEY. Всё стандартно, никаких хитростей.

По умолчанию действует лимит — 600 запросов в час. Этого хватает для большинства сценариев: если ты дёргаешь данные раз в 10 секунд для дашборда реального времени, то уложишься с запасом. Если нужно больше — смотри тарифные планы.

Реальный кейс: как мы выгрузили данные для отчёта за 2 минуты

Возьмём конкретный пример. Допустим, у тебя интернет-магазин с 10 000 посетителей в день. Тебе нужно каждое утро видеть в Telegram-боте:

сколько было визитов за предыдущий день;

топ-5 страниц по просмотрам;

основной источник трафика.

Раньше ты открывал три разных отчёта в панели аналитики, скроллил, копировал данные в Excel — это занимало 15-20 минут. С API KinMetric ты пишешь простой скрипт на Python (или даже curl-запрос в cron), который:

Получает список сайтов через /api/v1/sites.

Для нужного сайта (ID = 12345) делает запрос на /sites/12345/summary.

Вытаскивает оттуда visitors_today, pageviews_today.

Отдельно дёргает /top-pages?site_id=12345&limit=5 и /top-sources?site_id=12345&limit=1.

Формирует сообщение и отправляет в Telegram.

Скрипт выполняется за 1-2 секунды. Всё. Ты получаешь отчёт быстрее, чем заваривается кофе.

Вот пример, как может выглядеть ответ от эндпоинта /sites/{id}/summary (упрощённо):

{
"site_id": 12345,
"date": "2025-03-15",
"visitors": 10450,
"pageviews": 37800,
"bounce_rate": 32.5,
"avg_session_duration": 245
}

Ты забираешь эти цифры и используешь как хочешь: встраиваешь в свой дашборд, отправляешь в Slack, сохраняешь в базу для исторического анализа.

Пошаговая инструкция: как начать работу с API KinMetric

Если ты никогда не работал с API аналитики, не пугайся. Всё делается за 5 минут.

Зарегистрируйся в KinMetric (или войди в существующий аккаунт).

Добавь сайт, если ещё не добавил. Установи счётчик на страницы.

Перейди в раздел API в настройках дашборда.

Создай новый ключ. Дай ему понятное имя, например “Для скрипта ежедневной статистики”. Скопируй ключ — он покажется только один раз.

Сделай тестовый запрос. Открой терминал и выполни:

curl -H "Authorization: Bearer ТВОЙ_КЛЮЧ" https://api.kinmetric.cc/api/v1/sites

В ответ ты получишь JSON со списком твоих сайтов. Если видишь массив с объектами — всё работает.

Настрой регулярную выгрузку. Например, через cron раз в час или через GitHub Actions раз в день. Или просто встрой запросы в свой BI-инструмент.

Готово. Ты только что автоматизировал сбор аналитики.

Что ты выигрываешь, используя REST API вместо панели управления

Первое и главное — экономия времени. Вместо того чтобы кликать по интерфейсу, ты получаешь данные одной командой. Если у тебя 10 сайтов, ты не открываешь каждый отдельно — ты делаешь один запрос и получаешь всё сразу.

Второе — гибкость. Ты можешь комбинировать данные из разных источников. Например, брать конверсии из CRM, трафик из KinMetric, а расходы на рекламу из кабинетов — и сводить всё в один дашборд.

Третье — контроль. Ты сам решаешь, как часто обновлять данные, какие метрики выгружать и в каком формате их хранить. Никаких “система временно недоступна” или “данные ещё обрабатываются”.

И наконец, масштабируемость. Когда твой проект вырастет до сотен тысяч посетителей, ручной сбор статистики станет невозможен. API — единственный адекватный способ управлять аналитикой на больших объёмах.

Итог: когда стоит попробовать

REST API KinMetric — инструмент не для всех. Если у тебя один блог, который ты проверяешь раз в неделю, тебе хватит стандартного дашборда. Но если ты:

строишь собственную систему отчётов;

хочешь автоматизировать мониторинг;

объединяешь данные из нескольких сервисов;

просто устал от лишних кликов —

то это твой вариант. Попробуй бесплатно зарегистрироваться и создать первый ключ. А если хочешь изучить все эндпоинты и примеры запросов — смотри подробную документацию в каталоге. Там же можно проверить, подходит ли твой текущий тариф под нужное количество запросов, или посмотреть цены на расширенные лимиты.