Ask an AI coding agent about your Adapty analytics in plain language — revenue, conversions, retention, LTV — and let it pull the numbers for you. Point a tool that can make API calls at the Export Analytics API, and it queries your metrics on demand.

Что можно запрашивать

Export Analytics API возвращает те же метрики, что вы видите на графиках дашборда Adapty. Для каждой метрики предусмотрена отдельная операция:

Метрика	Что охватывает	Операция
Revenue, MRR, ARR, ARPU	Деньги, заработанные за период, сгруппированные по периоду, стране или кампании	retrieveAnalyticsData
Удержание когорты	Как долго подписчики из данной когорты продолжают платить	retrieveCohortData
Конверсии	Сколько пользователей переходит с одного шага или канала на следующий	retrieveConversionData
Отток и воронка	Где пользователи отваливаются и как быстро отписываются	retrieveFunnelData
Пожизненная ценность (LTV)	Средняя выручка на пользователя по сегментам за период	retrieveLTVData
Удержание	Доля пользователей, остающихся активными спустя N дней	retrieveRetentionData
Полный список параметров и фильтров см. в справочнике API.

Прежде чем начать

Вам понадобятся три вещи:

• Аккаунт Adapty с данными: API возвращает те же метрики, что и графики на дашборде, поэтому ваше приложение должно уже собирать аналитику.
• Секретный API-ключ: Найдите его в App settings → General, в поле Secret key. Ключи привязаны к конкретному приложению, поэтому используйте отдельный ключ для каждого из них. Сохраните ключ в переменную окружения (например, ADAPTY_SECRET_KEY), чтобы агент мог его считать без необходимости вставлять в чат вручную.
• AI-инструмент с возможностью вызова API: Например, Claude Code, Cursor или Claude Desktop с инструментом fetch. Обычные чат-инструменты вроде claude.ai или ChatGPT не могут напрямую обращаться к API.

Дайте агенту спецификацию API

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

Передайте агенту спецификацию по URL:

• Вставьте URL: Если ваш агент умеет загружать URL, дайте ему https://adapty.io/docs/ru/api-specs/export-analytics-api.yaml и попросите прочитать спецификацию.
• Используйте инструмент fetch: Если у вашего агента есть инструмент для загрузки URL (например, MCP fetch server), укажите ему тот же URL.

Спецификация задаёт базовый URL https://api-admin.adapty.io, так что агенту будет достаточно этого, как только ключ окажется в переменных окружения.

Задайте вопрос о своих данных

Загрузив спецификацию и указав ключ в переменной окружения, описывайте нужную метрику на обычном языке.

Примеры запросов:

What was my MRR at the end of each month this year, and how does it compare to last year?

Show my trial-to-paid conversion rate for the last 90 days, broken down by product.

Which countries drive the most revenue from my yearly subscription? Top 10.

How is week-1 retention trending for subscribers who started in the last 6 months?

What's the refund rate on my annual plan since launch, by month?

Compare LTV for paid-campaign users vs. organic over the last year, and export it as CSV.

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

Настройте один раз для повторного использования

Чтобы не повторять настройку каждый раз, сохраните спецификацию и ключ там, где агент сможет их повторно использовать:

• Сохраните ссылку на спецификацию: добавьте URL спецификации в правила или файл памяти вашего агента (например, CLAUDE.md или файл правил Cursor), чтобы он загружался при каждой сессии.
• Храните ключ в переменных окружения: добавьте ADAPTY_SECRET_KEY в профиль shell или хранилище секретов инструмента, чтобы больше не вводить его вручную.
• Сохраните часто используемые промпты или создайте кастомный скилл: держите типовые вопросы в виде сохранённых промптов или оберните их в кастомный скилл или slash-команду, чтобы агент запускал отчёт по запросу.

Ограничения

Учитывайте следующие ограничения:

• Ограничение частоты запросов: API допускает 2 запроса в секунду на один API-ключ. При превышении лимита возвращается ошибка 429 Too Many Requests. Настройте агент так, чтобы он ждал и повторял запрос при получении 429.
• Ключи привязаны к приложению: Каждый ключ работает только с одним приложением. Чтобы получать данные из нескольких приложений, используйте соответствующий ключ для каждого из них.
• Формат ответа: По умолчанию ответы возвращаются в формате JSON. Чтобы экспортировать данные в CSV, укажите format со значением csv в теле запроса.

Полное описание аутентификации и правил формирования запросов см. в разделе Авторизация и формат запроса.