Базовый адрес и аутентификация
Базовый адрес — https://storelift.net/v1. Создайте ключ в Settings → API; он показывается один раз и хранится только в виде хеша, поэтому потерянный ключ заменяют, а не восстанавливают.
Передавайте его как x-api-key или как bearer-токен, если клиент умеет только заголовки Authorization:
curl -s https://storelift.net/v1/apps \
-H "x-api-key: sl_live_..."27 эндпоинтов
| Эндпоинт | Что возвращает |
|---|---|
GET /v1/apps | Приложения, которые отслеживает этот аккаунт. Любой другой вызов начинается отсюда — id берётся из него. |
GET | Одно приложение плюс снимок последнего замера. |
GET | Текущая позиция по каждому отслеживаемому ключевому слову в одной витрине, с состоянием замера и глубиной поиска. |
GET | Приложения выше вас, каждое — с запросами, по которым оно вас обходит, и обеими позициями. |
GET | Называет ли ассистент ваше приложение для вашей категории, с сохранённым рядом. Нужен тариф Pro, Studio или Enterprise. |
GET | Ряд позиций по каждому ключевому слову, обрезанный до окна истории тарифа. |
GET | Ваша собственная страница в том виде, в каком её отдаёт стор, для обеих платформ, плюс обнаруженные на ней датированные изменения. |
GET | Свежие отзывы со сводкой звёзд, числом новых в этом замере и данными Play, если они измеряются. /reviews/search ищет по всему архиву по тексту, звёздам, версии и датам; /reviews/stats даёт распределение, кривую по дням и разбивку по версиям. |
GET | Датированные изменения карточки — версия, скриншоты, события, подборки, правки поля ключевых слов — каждое с движением позиций ключевых слов вокруг него. |
GET | Редакционные карточки, In-App Events и полка Apple «Вам также может понравиться» по странам, с датированной историей подборок и новых событий. |
GET | Позиция в топ-чарте для жанра и витрины приложения, с рядом. |
GET | Выручка и загрузки приложения из подключённых источников: единицы App Store Connect, установки Google Play, MRR, подписки и пробные периоды из RevenueCat. connected:false, если ничего не подключено. Scope revenue:read. |
GET | Число событий подписки из вебхука RevenueCat / Adapty — по дням, странам и месячным когортам. Scope revenue:read. |
GET | Показы в App Store → просмотры страницы → загрузки: точка за сегодня и история по дням из аналитики App Store Connect. Scope revenue:read. |
GET | Действующие цены по продуктам и странам и каждый период с фиксированной ценой — с пробными периодами, первыми оплатами и выручкой, плюс промокоды, из вебхука RevenueCat / Adapty. Scope revenue:read. |
GET | Кампании Apple Ads, продвигающие приложение (сопоставляются по App Store id): расходы, тапы, установки, бюджет и статус, плюс главные ключевые слова и поисковые запросы. Scope ads:read. |
Эндпоинты ниже /apps/{id} принимают country (код витрины, например us, по умолчанию — первая витрина приложения) и, если измеряются оба стора, platform=ios|android.
Три состояния замера сохраняются при передаче
Эту часть стоит прочитать до того, как писать интеграцию. Поле позиции может быть числом, но отсутствие числа означает две разные вещи, и API их разделяет:
measured: true,rank: 7— приложение найдено на позиции 7.measured: true,rank: null— поиск выполнен, но приложения не было в результатах доsearchDepth.measured: false— в этот день поиск выполнить не удалось. О позиции ничего не известно.
{
"country": "de",
"platform": "ios",
"live": true,
"measuredAt": "2026-09-19T02:14:08.921Z",
"keywords": [
{ "term": "traumdeutung", "measured": true, "rank": 7, "demand": 6, "searchDepth": 200 },
{ "term": "traumsymbole", "measured": true, "rank": null, "demand": 3, "searchDepth": 200 },
{ "term": "traumtagebuch", "measured": false, "rank": null, "demand": null, "searchDepth": null }
]
}Если свести два последних случая к нулю, получится обвал, которого не было, и все средние, построенные поверх, будут неверны. Если вашему коду нужно одно число, считайте measured: false пропуском в ряду, а не значением.
Аккаунт, расход и поиск
Четыре эндпоинта о самом ключе и собственных записях аккаунта. Первые два бесплатны, поэтому скрипт может до начала работы проверить, что ему доступно и сколько осталось. search и fetch повторяют формат, который ChatGPT ожидает от коннектора для deep research: запрос возвращает id, id возвращает запись.
| Эндпоинт | Что возвращает |
|---|---|
GET /v1/account | Кому принадлежит ключ: тариф, способ аутентификации, scopes, доступные приложения, баланс кредитов. 0 кредитов. |
GET /v1/usage | Каждая квота с used / limit / reset, дневной лимит Hive на сегодня и лимит запросов в секунду. 0 кредитов. |
GET | Поиск по вашим приложениям, отслеживаемым ключевым словам и конкурентам; возвращает id для /v1/fetch (формат deep research ChatGPT). |
GET | Полная запись по id из поиска: карточка приложения, одно ключевое слово с историей или один конкурент с запросами, по которым он вас опережает. |
Hive: любое приложение, любой рынок
Эндпоинты выше читают ваши отслеживаемые приложения. Эндпоинты Hive читают то, что измеряет вся сеть: чарты, дневной замер любого приложения, списки выдачи по ключевым словам, ключевые слова конкурента, а также выручку и загрузки любого приложения. Им нужен отдельный scope на ключе, и за вызов они списывают больше кредитов; у каждого тарифа также есть дневной лимит Hive, чтобы месячных кредитов хватало на весь месяц.
| Эндпоинт | Что возвращает | Scope |
|---|---|---|
GET | Список Top Free, Top Grossing или iPad витрины (глубиной 100) на последний день. | hive:read |
GET | Последний дневной замер любого приложения: число оценок, рейтинг, версия, цена, распределение звёзд, значок категории, а также поддерживаемые языки, предстоящие события в приложении, рекламный текст и продвигаемые покупки в приложении. | hive:read |
GET | Кто занимал позиции по ключевому слову, день за днём (1 000 строк за вызов). | hive:read |
GET | Ключевые слова, по которым ранжируется конкурент, — с тем же фильтром приватности и месячным лимитом spy, что и в дашборде. | hive:spy |
GET | Месячная выручка и загрузки любого приложения App Store по всему миру (202, пока идёт первое чтение). | hive:estimate |
GET | Кто поднялся, кто опустился, кто вошёл и кто выбыл из одного топ-чарта по сравнению с тем же чартом N дней назад. Каждое изменение считается между двумя измеренными днями, и ответ называет оба. | hive:read |
GET | Приложения, впервые попавшие в топ-чарт, сначала самые новые. Ответ показывает, сколько из этих дней покрывает индекс, так что каждая дата первого появления — день, который мы проиндексировали. | hive:read |
GET | Поиск приложений по измеряемым нами чартам: фильтр по категории, витрине, чарту (Top Grossing, Top Free, Top Paid, Top iPad), диапазону позиций, дате первого появления, названию или издателю. В каждой строке — выручка и загрузки приложения. | hive:read |
GET | Разрыв по ключевым словам для пяти приложений рядом: по какому запросу каждое ранжируется и какой упускает. Hive Explorer. Тот же фильтр приватности, что и у spy, а у каждого приложения своё состояние замера, так что каждая ячейка таблицы — измеренный факт. | hive:spy |
GET | Все приложения одного издателя, которые видел Hive, с днём первого попадания каждого в чарт. | hive:read |
GET | Id любого приложения по названию, разработчику, ссылке на магазин, id App Store или имени пакета. Названия ищутся через поиск App Store этого магазина. | hive:read |
GET | Полка похожих приложений магазина для любого приложения, в порядке полки, с категорией и названием каждого и датой чтения. | hive:read |
GET | Свежие отзывы любого приложения в одном магазине с распределением звёзд; без имён авторов. | hive:read |
Личные данные здесь остаются закрытыми: авторы отзывов не показываются, а ключевое слово конкурента видно, только если его отслеживают как минимум два других аккаунта или вы сами.
Попробуйте без ключа
Каждый путь есть и под /v1/sandbox/ — совсем без ключа: те же структуры, фиксированный набор данных из двух приложений, даты, которые сдвигаются вместе со вчерашним днём. Ответы содержат x-sandbox: true. Для CI можно создать в Settings тестовый ключ (sl_test_): он отвечает только из песочницы, не тратит кредиты и работает на каждом тарифе, так что утёкший тестовый ключ ничего не раскрывает.
curl -s https://storelift.net/v1/sandbox/apps
curl -s 'https://storelift.net/v1/sandbox/hive/keywords/sleep%20sounds/ranks?country=us&days=3&top=10'Как работают запись и scopes
- Каждая запись сначала проходит предпросмотр. Чтение — это
GET.POST /v1/actionsвозвращает diff «до/после», стоимость в кредитах и одноразовый токен, ничего не меняя;POST /v1/actions/confirmприменяет изменение. Токен привязан к действию, аргументам и состоянию цели в момент предпросмотра, поэтому если цель за это время изменилась, confirm возвращаетconfirm_token_mismatchс новым diff и ничего не записывает. Действия охватывают ключевые слова, конкурентов, приложения, ссылки для просмотра и ответы на отзывы (с Pro), а на Studio — тексты страницы в редактируемой версии App Store и паузу, возобновление и дневной бюджет Apple Ads. Полный список — в справочнике. - Scopes на запись включаются по выбору. Каждой записи нужен свой scope (
track:write,reports:write,reviews:write,ads:write,listing:write); при создании ключа они выключены. Тестовые ключи отвечают из песочницы и оставляют ваши данные как есть. Оплата остаётся в настройках аккаунта. - Проверьте дату и состояние наблюдения. Ответ может содержать сохранённое измерение, подтверждённое отсутствие данных, ожидающую задачу или ошибку. Повторный запрос не обновляет дату старого наблюдения.
- Слой выручки закрыт отдельными scopes. Десять эндпоинтов роста (
revenue,subscriptions,funnel,pricing,change-impact,campaigns,ads-keywords,ads-search-terms,ads-commands,search-popularity) отвечают ключу, созданному с чувствительными scopesrevenue:read/ads:read, так что ключ открывает данные о выручке, только когда вы это выбираете. GA4 находится в дашборде. - История следует тарифу.
historyиchartsиспользуют окно тарифа, поэтому один и тот же ключ достаёт ровно так же далеко через любой из них.
Ошибки
| Статус | error | Когда |
|---|---|---|
| 401 | missing_api_key | В запросе нет ключа. |
| 401 | invalid_api_key | Ключ неизвестен или отозван. |
| 401 | account_deleted | Аккаунт, которому принадлежал ключ, удалён. |
| 403 | plan_required | Доступ к API на этом тарифе закрыт. В ответе указан текущий тариф. |
| 405 | method_not_allowed | Чтение — это GET; POST принимают /v1/actions, /v1 и /v1 (черновик передаётся в теле). |
| 400 | unknown_action | Такого действия нет в каталоге; ответ перечисляет доступные. |
| 400 | invalid_arguments | Аргумент отсутствует или задан неверно; ответ называет поле. |
| 409 | confirm_token_expired | Токену больше 10 минут. Сделайте предпросмотр ещё раз. |
| 409 | confirm_token_mismatch | Цель изменилась после предпросмотра; ответ содержит новый diff. |
| 403 | write_limit_reached | Запись выходит за защитные рамки (шаг бюджета, число действий за день). |
| 403 | test_key_read_only | Тестовые ключи отвечают только из песочницы. |
| 404 | job_not_found | Задачи с таким id в этом рабочем пространстве нет. |
| 403 | workspace_suspended | Рабочее пространство приостановлено; причину сообщит поддержка. |
| 403 | ip_list_required | В этом рабочем пространстве у каждого ключа должен быть список разрешённых IP. |
| 404 | not_found | Такого id приложения нет в этом аккаунте. |
| 404 | unknown_endpoint | Такого пути под /v1 нет. |
| 402 | credits_exhausted | Кредиты этого месяца израсходованы; ответ ведёт на пакет кредитов. |
| 429 | rate_limited | Слишком много запросов для этого ключа; подождите столько секунд, сколько указано в Retry-After. |
| 429 | daily_hive_limit | Дневной лимит Hive по тарифу на сегодня израсходован; он обновляется в 00:00 UTC. |
| 404 | not_measured | Для указанного приложения, ключевого слова или области запроса нет подтверждённого наблюдения. Отсутствие данных не означает ноль. Проверьте параметры запроса и доступные действия в документации по ссылке из ответа. |
| 400 | bad_query | /v1/search нужен q длиной 1–120 символов. |
| 400 | bad_id | /v1/fetch нужен id ровно в том виде, в каком его вернул /v1/search. |
| 403 | asc_required | update_listing нужен подключённый ключ App Store Connect. |
| 403 | asc_role | Для правки метаданных ключу App Store Connect нужна роль Admin или App Manager. |
| 409 | no_editable_version | Редактируемой версии App Store сейчас нет; ответ перечисляет состояния текущих версий. |
| 404 | locale_not_found | Этого языка витрины нет в версии; ответ перечисляет те, что есть. |
| 409 | changed_since_preview | Страница изменилась в App Store Connect после предпросмотра; ничего не записано. |
| 422 | asc_rejected | App Store Connect отклонил изменение; его собственное сообщение — в detail. |
| 409 | in_progress | Запись для той же цели ещё выполняется. |
| 403 | ip_not_allowed | У ключа есть список разрешённых IP, а запрос пришёл с другого адреса. |
| 401 | key_leaked | Ключ нашли в публичном репозитории и автоматически отозвали; создайте новый. |
Каждая ошибка — это JSON с полем error. plan_required также возвращает plan, чтобы клиент мог сообщить, на каком тарифе ключ, а не гадать.
Частые вопросы
Есть ли ограничение частоты запросов?
Да, на каждый ключ: число запросов в секунду по тарифу (429 с Retry-After), месячный запас кредитов, который показывают заголовки x-credits-*, и дневной лимит Hive. Каждый вызов также обновляет счётчик использования ключа, чтобы в Settings было видно, используется ли ещё старый ключ.
Можно ли пользоваться им на бесплатном тарифе?
Рабочие ключи для API — с Pro. Песочница без ключа и тестовые ключи работают на каждом тарифе, удалённый MCP-сервер доступен с Pro, бесплатным инструментам на этом сайте аккаунт не нужен вовсе, а бесплатный тариф ежедневно измеряет одно приложение.
API или MCP-сервер?
Скрипту нужен API: фиксированные структуры, один вызов, без модели в цепочке. Ассистенту нужен MCP-сервер, потому что у инструментов есть собственные описания и он может выбрать нужный вызов без того, чтобы вы писали интеграцию. Оба работают с одними и теми же замерами, и оба записывают через один и тот же шаг «предпросмотр, затем подтверждение».
Проверьте на своём приложении
Вставьте ссылку на приложение и добавьте ключевые слова. Позиция, приложения выше вас и спрос измеряются каждый день.
Бесплатный план: 1 приложение, по 10 ключевых слов в 2 витринах, 14 дней истории, без карты и без срока. Pro — $29/мес.
Начать бесплатно →
