Что это
PostHog API помогает получить данные о поведении пользователей без ручного копирования из кабинета. Например, программа считает события регистрации за неделю и передает итог в отчет. Достоверность такого отчета начинается с правильных событий, периода и правил подсчета.
Здесь описан интерфейс данных, а не отдельный AI-помощник PostHog. API не объясняет автоматически, почему упала конверсия. Он может предоставить факты для анализа вашим кодом или моделью; гипотезы потом проверяют отдельно.
Не путайте публичную отправку событий с приватным чтением проекта. Project token для сбора событий не заменяет Personal API key для запросов. Первый тест лучше ограничить агрегатом без email, текстов переписки и других персональных сведений.
Ключевые параметры
- Категория: Операционные задачи
- Сложность: Для разработчика
- Запуск: Около 30 минут
- Open-source: Да
- Данные: Не известно
- Чувствительные данные: Только с настройками
Сильные стороны
- HogQL позволяет явно задать период, группировку и правила подсчета.
- Приватный API можно подключить к собственному скрипту или автоматизации.
- Персональному ключу можно выдать только нужные разрешения и ограничить доступ к проектам.
- Бесплатные квоты позволяют проверить небольшой сценарий до масштабирования расходов.
Ограничения
- Ошибки сбора, повторные события и неверный период искажают результат независимо от API.
- Методы имеют лимиты; дорогие запросы и повторы нужно ограничивать.
- Query API не предназначен для массового экспорта; программный OFFSET через Personal API key не поддерживается.
- Self-hosted-развертывание официально не поддерживается: обслуживание и риски остаются у владельца.
Как использовать
1. Подготовка. Выберите учебный проект с уже поступающими событиями. Запишите его project_id, регион US или EU и ожидаемый небольшой показатель. Для начала считайте события, а не уникальных пользователей.
2. Настройка. Создайте Personal API key с разрешением Query Read только для нужного проекта. Сохраните его на сервере вне кода. Для US используйте https://us.posthog.com, для EU https://eu.posthog.com; хост приема событий с i. здесь не нужен.
3. Первый результат. Отправьте POST /api/projects/{project_id}/query/ с Authorization: Bearer и Content-Type: application/json. Тело: {"query":{"kind":"HogQLQuery","query":"SELECT count() FROM events WHERE timestamp >= now() - INTERVAL 7 DAY"}}. Сохраните результат и время проверки; учтите признак кеширования.
4. Проверка. Сравните число с тем же SQL-запросом в интерфейсе проекта. Затем зафиксируйте одинаковые границы периода и часовой пояс для регулярного отчета. При 429 учитывайте Retry-After. Для массовых выгрузок используйте batch exports, а не обход ограничений Query API.
Примеры сценариев
- Собрать число регистраций за согласованный период.
- Проверить, что событие поступает после изменения продукта.
- Подготовить агрегаты для обсуждения удержания без передачи профилей пользователей.
Доступ и оплата
- Модель оплаты: Оплата по использованию
- Бесплатный тариф: Да
- Работа в РФ: Нужно проверять
- VPN: Не известно
- Русский интерфейс: Не известно
- Русский язык: Не известно
Cloud имеет бесплатные квоты по продуктам и оплату превышения. Открытое ядро имеет MIT-лицензию, но ee-компоненты лицензируются отдельно. Self-hosting возможен без гарантированной поддержки и не равен всем платным функциям Cloud. Доступность и оплату из России здесь не подтверждаем.
Когда не подходит
- Объяснять причины изменений только по числу событий
- Скачать весь проект через бесконечный OFFSET
- Размещать приватный ключ в браузерном коде
Альтернативы
Amplitude API и Google Analytics Data API подходят для аналитики соответствующих систем. Metabase API удобен для отчетов над своей базой. Их показатели нельзя напрямую сопоставлять без одинаковых определений событий и пользователей.
