REST API аналитики сайтов: забирай любые метрики через JSON

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

Знакомая картина: ты разработчик или маркетолог, который отвечает за сайт. Утром в понедельник открываешь стандартную панель аналитики, чтобы скинуть отчёт руководителю, а нужного показателя там нет. Или данные за вчера подгружаются только к обеду. Или, что ещё хуже, ты хочешь склеить посещаемость с продажами из CRM, но аналитика живёт в своём закрытом мире.

Сервис KinMetric решает эту проблему через REST API. Это не просто набор эндпоинтов, а полноценный инструмент, который отдаёт любые метрики сайта в формате JSON. Ты можешь забрать данные, обработать их как хочешь и встроить в свои дашборды, отчёты или даже в интерфейс клиента. Без посредников, без копипаста из админки.

Что такое REST API в KinMetric и как оно работает

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

Технически это выглядит так:

Ты создаёшь именованный ключ в разделе Dashboard → API. Ключ хранится в базе данных в зашифрованном виде — даже если кто-то получит доступ к дампу БД, ключ останется недоступен.

Каждый запрос к API требует авторизации через заголовок Authorization: Bearer YOUR_KEY.

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

Все эндпоинты имеют префикс /api/v1/. Вот основные из них, которые пригодятся в работе:

/sites — список всех сайтов в аккаунте.

/sites/{id}/summary — сводка по конкретному сайту: визиты, уникальные посетители, просмотры, отказы, глубина просмотра, среднее время на сайте.

/visitors — детальная информация о посетителях за период.

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

/top-sources — откуда приходят люди: поиск, соцсети, прямые заходы, рефералы.

/top-countries — география по странам.

/realtime — активные посетители прямо сейчас.

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

Представь агентство, которое ведёт три сайта: интернет-магазин, блог и лендинг. Раньше менеджеры каждое утро вручную собирали цифры из панели и вставляли в Google Sheets. На это уходило 20-30 минут в день. Ошибки, опоздания, человеческий фактор.

Через REST API KinMetric мы написали простой скрипт на Python. Он раз в час дёргает /sites/{id}/summary для каждого проекта, забирает summary-данные и записывает их в базу данных. На выходе — таблица с метриками по дням, которую можно подключить к любому BI-инструменту. Цифры:

Было: 20 минут ручного сбора данных в день.

Стало: 0 минут. Скрипт работает в фоне.

Ошибки: исчезли полностью.

Затраты по API: около 300 запросов в день на три сайта — это 50% от лимита.

Дополнительно мы добавили realtime-виджет для лендинга: через /realtime показываем на внутренней панели, сколько людей сейчас на сайте. Это помогло оперативно реагировать на всплески трафика во время рекламных кампаний.

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

Создай ключ. Зайди в раздел Dashboard → API. Нажми «Создать ключ». Дай ему имя, например «Мой первый ключ». После создания ключ отобразится один раз — скопируй его сразу. Он хранится в зашифрованном виде, восстановить его из панели нельзя.

Проверь доступность сайта. Отправь GET-запрос на https://api.kinmetric.cc/api/v1/sites с заголовком Authorization: Bearer YOUR_KEY. В ответе придёт JSON со списком твоих сайтов и их ID.

Получи summary. Возьми ID нужного сайта и отправь запрос на /sites/{id}/summary. Параметры: period=last_7_days или from=2023-10-01&to=2023-10-31. В ответе — визиты, уникальные посетители, просмотры, отказы, глубина просмотра, время на сайте.

Забери топ-страницы. Эндпоинт /top-pages с теми же параметрами вернёт массив страниц, отсортированных по популярности. Полезно для контент-анализа.

Подключи realtime. Эндпоинт /realtime без параметров вернёт количество активных посетителей за последние 5 минут. Можно опрашивать раз в 10-15 секунд.

Весь ответ — чистый JSON. Никакой лишней обёртки. Парсишь, агрегируешь, строишь свои дашборды. Если нужно больше — изучи полную документацию в каталоге.

Что ты получаешь, используя REST API KinMetric

Гибкость. Ты не привязан к интерфейсу сервиса. Хочешь вывести данные в Grafana? Пожалуйста. Хочешь сделать свой кастомный отчёт для клиента? Без проблем. Хочешь склеить с CRM? API отдаёт всё, что нужно.

Скорость. Данные приходят мгновенно. Никаких задержек на рендеринг страницы. Для summary-запроса ответ приходит за 50-200 мс в зависимости от объёма данных.

Безопасность. Ключи хранятся в зашифрованном виде. Ты можешь создать отдельный ключ для каждого скрипта или сервиса. Если один ключ скомпрометирован — отзываешь его, а остальные продолжают работать.

Экономия времени. Вместо того чтобы вручную собирать отчёты, ты автоматизируешь процесс один раз. Дальше данные льются сами.

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

Посмотри подробное описание всех эндпоинтов в каталоге или зарегистрируйся и попробуй бесплатно. Первый ключ создаётся за 30 секунд.