Документация для разработчиков › Справочник API
Эндпоинты аккаунта
Тариф, права доступа и расход самого ключа, поиск по аккаунту и лента оповещений. Чтение тарифа и расхода стоит 0 кредитов.
Аутентификация · Кредиты · Общие параметры · Коды ошибок · openapi.json
GET /alerts
Лента оповещений этого рабочего пространства — падения и рост позиций, ключевые слова, вошедшие в результаты или выпавшие из них, конкуренты, которые обошли вас или которых обошли вы, изменения страниц конкурентов в магазине, шаги правил и комиссии за управление Apple Ads, завершённые подборы ключевых слов — сначала новые, с числом непрочитанных. Та же лента, что под колокольчиком в панели.
| Параметр | Где | Тип | Описание |
|---|---|---|---|
limit | query | number | строки, до 500 (по умолчанию 50) |
curl "https://storelift.net/v1/alerts" \
-H "Authorization: Bearer $STORELIFT_API_KEY"GET /portfolio
Сегодняшний день по всем приложениям рабочего пространства, по строке на приложение: пользователи онлайн, пользователи и новые пользователи, доход от рекламы, доход от подписок и пробные периоды, а также итоги по портфелю, карточки по часам и странам и лента событий подписок. Те же цифры, что на экране «Сегодня» в панели. Передайте day, чтобы получить прошедший день.
| Параметр | Где | Тип | Описание |
|---|---|---|---|
tz | query | string | часовой пояс IANA для границы дня, например Europe/Istanbul (по умолчанию UTC) |
day | query | string | прошедший день в формате YYYY-MM-DD (по умолчанию сегодня) |
curl "https://storelift.net/v1/portfolio" \
-H "Authorization: Bearer $STORELIFT_API_KEY"GET /account
Кому принадлежит этот ключ или сессия: тариф, способ аутентификации, области доступа, приложения, которые можно читать, и баланс кредитов. Кредиты не расходуются. Вызывайте, когда запрос отклонён из-за тарифа, области доступа или приложения.
curl "https://storelift.net/v1/account" \
-H "Authorization: Bearer $STORELIFT_API_KEY"Пример ответа
GET /usage
Все лимиты рабочего пространства с расходом и временем сброса: отслеживаемые ключевые слова, приложения, подбор, вопросы к ИИ, ИИ для отзывов, видимость в ИИ, шпион, кредиты API, сегодняшний лимит Hive и ограничение запросов в секунду. Кредиты не расходуются. used=null означает, что на этом тарифе лимит не учитывается, а не что он равен нулю.
curl "https://storelift.net/v1/usage" \
-H "Authorization: Bearer $STORELIFT_API_KEY"Пример ответа
GET /search
Поиск по собственным записям аккаунта — названиям приложений и id в магазине, отслеживаемым ключевым словам и приложениям конкурентов, которые стоят выше пользователя; возвращает список id для передачи в fetch. Используйте, чтобы найти запись; чтобы находить новые приложения по всему магазину, используйте find_apps.
| Параметр | Где | Тип | Описание |
|---|---|---|---|
qобязательный | query | string | произвольный текст: название приложения, ключевое слово, название конкурента или id в магазине |
curl "https://storelift.net/v1/search?q=sleep" \
-H "Authorization: Bearer $STORELIFT_API_KEY"Пример ответа
GET /fetch
Полная запись по одному id из search: карточка приложения, одно отслеживаемое ключевое слово с текущим состоянием и историей позиций или один конкурент с ключевыми словами, по которым он опережает пользователя. Возвращает id, title, url, текст в одну строку и metadata.
| Параметр | Где | Тип | Описание |
|---|---|---|---|
idобязательный | query | string | id в точности как его вернул search (app:…, kw:…, rival:…) |
curl "https://storelift.net/v1/fetch?id=kw%3Asbx-lumen%3Aus%3Asleep%2520sounds" \
-H "Authorization: Bearer $STORELIFT_API_KEY"