Storelift

Storelift › Руководства › Storelift API

ИИ-слой

Storelift API

Всё, что показывает дашборд, доступно и как JSON-эндпоинт. 27 эндпоинтов GET читают ваши отслеживаемые приложения и рынок в целом, а POST /v1/actions показывает предпросмотр изменения, которое затем применяет POST /v1/actions/confirm, — так скрипт, задача в таблице или шаг CI читают те же числа и действуют по ним. API входит в Pro и Studio. Полный справочник — на /docs/api/, машиночитаемая спецификация — на /openapi.json (OpenAPI 3.1); ассистенту, который работает с теми же данными, обычно лучше подходит MCP-сервер — он тоже доступен с тарифа Pro.

Начать бесплатно →Бесплатный план: 1 приложение, по 10 ключевых слов в 2 витринах, 14 дней истории, без карты и без срока. Pro — $29/мес.

Автор: Обновлено: 9 мин чтения

Отслеживание ключевых слов · история позиций, изменения за неделю и отслеживаемые слова

Базовый адрес и аутентификация

Базовый адрес — https://storelift.net/v1. Создайте ключ в Settings → API; он показывается один раз и хранится только в виде хеша, поэтому потерянный ключ заменяют, а не восстанавливают.

Передавайте его как x-api-key или как bearer-токен, если клиент умеет только заголовки Authorization:

Terminal
curl -s https://storelift.net/v1/apps \
  -H "x-api-key: sl_live_..."
Доступ к API есть на тарифах Pro и Studio — от $29 в месяц, $99 за Studio. При понижении тарифа ключ сохраняется, поэтому повторное повышение возвращает ту же интеграцию.

27 эндпоинтов

ЭндпоинтЧто возвращает
GET /v1/appsПриложения, которые отслеживает этот аккаунт. Любой другой вызов начинается отсюда — id берётся из него.
GET /v1/apps/{id}Одно приложение плюс снимок последнего замера.
GET /v1/apps/{id}/keywordsТекущая позиция по каждому отслеживаемому ключевому слову в одной витрине, с состоянием замера и глубиной поиска.
GET /v1/apps/{id}/rivalsПриложения выше вас, каждое — с запросами, по которым оно вас обходит, и обеими позициями.
GET /v1/apps/{id}/aiНазывает ли ассистент ваше приложение для вашей категории, с сохранённым рядом. Нужен тариф Pro, Studio или Enterprise.
GET /v1/apps/{id}/historyРяд позиций по каждому ключевому слову, обрезанный до окна истории тарифа.
GET /v1/apps/{id}/pageВаша собственная страница в том виде, в каком её отдаёт стор, для обеих платформ, плюс обнаруженные на ней датированные изменения.
GET /v1/apps/{id}/reviewsСвежие отзывы со сводкой звёзд, числом новых в этом замере и данными Play, если они измеряются. /reviews/search ищет по всему архиву по тексту, звёздам, версии и датам; /reviews/stats даёт распределение, кривую по дням и разбивку по версиям.
GET /v1/apps/{id}/timelineДатированные изменения карточки — версия, скриншоты, события, подборки, правки поля ключевых слов — каждое с движением позиций ключевых слов вокруг него.
GET /v1/apps/{id}/featuringРедакционные карточки, In-App Events и полка Apple «Вам также может понравиться» по странам, с датированной историей подборок и новых событий.
GET /v1/apps/{id}/chartsПозиция в топ-чарте для жанра и витрины приложения, с рядом.
GET /v1/apps/{id}/revenueВыручка и загрузки приложения из подключённых источников: единицы App Store Connect, установки Google Play, MRR, подписки и пробные периоды из RevenueCat. connected:false, если ничего не подключено. Scope revenue:read.
GET /v1/apps/{id}/subscriptionsЧисло событий подписки из вебхука RevenueCat / Adapty — по дням, странам и месячным когортам. Scope revenue:read.
GET /v1/apps/{id}/funnelПоказы в App Store → просмотры страницы → загрузки: точка за сегодня и история по дням из аналитики App Store Connect. Scope revenue:read.
GET /v1/apps/{id}/pricingДействующие цены по продуктам и странам и каждый период с фиксированной ценой — с пробными периодами, первыми оплатами и выручкой, плюс промокоды, из вебхука RevenueCat / Adapty. Scope revenue:read.
GET /v1/apps/{id}/campaignsКампании 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 — в этот день поиск выполнить не удалось. О позиции ничего не известно.
JSON
{
  "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 /v1/search?q=Поиск по вашим приложениям, отслеживаемым ключевым словам и конкурентам; возвращает id для /v1/fetch (формат deep research ChatGPT).
GET /v1/fetch?id=Полная запись по id из поиска: карточка приложения, одно ключевое слово с историей или один конкурент с запросами, по которым он вас опережает.

Hive: любое приложение, любой рынок

Эндпоинты выше читают ваши отслеживаемые приложения. Эндпоинты Hive читают то, что измеряет вся сеть: чарты, дневной замер любого приложения, списки выдачи по ключевым словам, ключевые слова конкурента, а также выручку и загрузки любого приложения. Им нужен отдельный scope на ключе, и за вызов они списывают больше кредитов; у каждого тарифа также есть дневной лимит Hive, чтобы месячных кредитов хватало на весь месяц.

ЭндпоинтЧто возвращаетScope
GET /v1/hive/charts?country=&kind=&genre=Список Top Free, Top Grossing или iPad витрины (глубиной 100) на последний день.hive:read
GET /v1/hive/apps/{storeId}?country=Последний дневной замер любого приложения: число оценок, рейтинг, версия, цена, распределение звёзд, значок категории, а также поддерживаемые языки, предстоящие события в приложении, рекламный текст и продвигаемые покупки в приложении.hive:read
GET /v1/hive/keywords/{term}/ranks?country=&days=&top=Кто занимал позиции по ключевому слову, день за днём (1 000 строк за вызов).hive:read
GET /v1/hive/spy/{storeId}?country=Ключевые слова, по которым ранжируется конкурент, — с тем же фильтром приватности и месячным лимитом spy, что и в дашборде.hive:spy
GET /v1/hive/estimate/{storeId}?country=Месячная выручка и загрузки любого приложения App Store по всему миру (202, пока идёт первое чтение).hive:estimate
GET /v1/hive/movers?country=&kind=&genre=&days=&limit=Кто поднялся, кто опустился, кто вошёл и кто выбыл из одного топ-чарта по сравнению с тем же чартом N дней назад. Каждое изменение считается между двумя измеренными днями, и ответ называет оба.hive:read
GET /v1/hive/new?days=&country=&limit=Приложения, впервые попавшие в топ-чарт, сначала самые новые. Ответ показывает, сколько из этих дней покрывает индекс, так что каждая дата первого появления — день, который мы проиндексировали.hive:read
GET /v1/hive/find?genre=&country=&kind=&released=&rankMin=&rankMax=&text=&publisher=&page=Поиск приложений по измеряемым нами чартам: фильтр по категории, витрине, чарту (Top Grossing, Top Free, Top Paid, Top iPad), диапазону позиций, дате первого появления, названию или издателю. В каждой строке — выручка и загрузки приложения.hive:read
GET /v1/hive/gap?ids=&country=&platform=Разрыв по ключевым словам для пяти приложений рядом: по какому запросу каждое ранжируется и какой упускает. Hive Explorer. Тот же фильтр приватности, что и у spy, а у каждого приложения своё состояние замера, так что каждая ячейка таблицы — измеренный факт.hive:spy
GET /v1/hive/publisher/{publisherId}Все приложения одного издателя, которые видел Hive, с днём первого попадания каждого в чарт.hive:read
GET /v1/hive/resolve?q=&country=&limit=Id любого приложения по названию, разработчику, ссылке на магазин, id App Store или имени пакета. Названия ищутся через поиск App Store этого магазина.hive:read
GET /v1/hive/similar/{storeId}?country=Полка похожих приложений магазина для любого приложения, в порядке полки, с категорией и названием каждого и датой чтения.hive:read
GET /v1/hive/reviews/{storeId}?country=&limit=Свежие отзывы любого приложения в одном магазине с распределением звёзд; без имён авторов.hive:read

Личные данные здесь остаются закрытыми: авторы отзывов не показываются, а ключевое слово конкурента видно, только если его отслеживают как минимум два других аккаунта или вы сами.

Попробуйте без ключа

Каждый путь есть и под /v1/sandbox/ — совсем без ключа: те же структуры, фиксированный набор данных из двух приложений, даты, которые сдвигаются вместе со вчерашним днём. Ответы содержат x-sandbox: true. Для CI можно создать в Settings тестовый ключ (sl_test_): он отвечает только из песочницы, не тратит кредиты и работает на каждом тарифе, так что утёкший тестовый ключ ничего не раскрывает.

Terminal
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) отвечают ключу, созданному с чувствительными scopes revenue:read / ads:read, так что ключ открывает данные о выручке, только когда вы это выбираете. GA4 находится в дашборде.
  • История следует тарифу. history и charts используют окно тарифа, поэтому один и тот же ключ достаёт ровно так же далеко через любой из них.

Ошибки

СтатусerrorКогда
401missing_api_keyВ запросе нет ключа.
401invalid_api_keyКлюч неизвестен или отозван.
401account_deletedАккаунт, которому принадлежал ключ, удалён.
403plan_requiredДоступ к API на этом тарифе закрыт. В ответе указан текущий тариф.
405method_not_allowedЧтение — это GET; POST принимают /v1/actions, /v1/actions/confirm и /v1/apps/{id}/validate-listing (черновик передаётся в теле).
400unknown_actionТакого действия нет в каталоге; ответ перечисляет доступные.
400invalid_argumentsАргумент отсутствует или задан неверно; ответ называет поле.
409confirm_token_expiredТокену больше 10 минут. Сделайте предпросмотр ещё раз.
409confirm_token_mismatchЦель изменилась после предпросмотра; ответ содержит новый diff.
403write_limit_reachedЗапись выходит за защитные рамки (шаг бюджета, число действий за день).
403test_key_read_onlyТестовые ключи отвечают только из песочницы.
404job_not_foundЗадачи с таким id в этом рабочем пространстве нет.
403workspace_suspendedРабочее пространство приостановлено; причину сообщит поддержка.
403ip_list_requiredВ этом рабочем пространстве у каждого ключа должен быть список разрешённых IP.
404not_foundТакого id приложения нет в этом аккаунте.
404unknown_endpointТакого пути под /v1 нет.
402credits_exhaustedКредиты этого месяца израсходованы; ответ ведёт на пакет кредитов.
429rate_limitedСлишком много запросов для этого ключа; подождите столько секунд, сколько указано в Retry-After.
429daily_hive_limitДневной лимит Hive по тарифу на сегодня израсходован; он обновляется в 00:00 UTC.
404not_measuredДля указанного приложения, ключевого слова или области запроса нет подтверждённого наблюдения. Отсутствие данных не означает ноль. Проверьте параметры запроса и доступные действия в документации по ссылке из ответа.
400bad_query/v1/search нужен q длиной 1–120 символов.
400bad_id/v1/fetch нужен id ровно в том виде, в каком его вернул /v1/search.
403asc_requiredupdate_listing нужен подключённый ключ App Store Connect.
403asc_roleДля правки метаданных ключу App Store Connect нужна роль Admin или App Manager.
409no_editable_versionРедактируемой версии App Store сейчас нет; ответ перечисляет состояния текущих версий.
404locale_not_foundЭтого языка витрины нет в версии; ответ перечисляет те, что есть.
409changed_since_previewСтраница изменилась в App Store Connect после предпросмотра; ничего не записано.
422asc_rejectedApp Store Connect отклонил изменение; его собственное сообщение — в detail.
409in_progressЗапись для той же цели ещё выполняется.
403ip_not_allowedУ ключа есть список разрешённых IP, а запрос пришёл с другого адреса.
401key_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/мес.

Начать бесплатно →
Наборы конкурентов · слова, общие с конкурентом, и те, что есть только у него

Читайте также