Documentación para desarrolladores › Referencia de la API
Endpoints de cuenta
El plan, los scopes y el uso de la propia clave, la búsqueda en la cuenta y el feed de alertas. Leer el plan y el uso cuesta 0 créditos.
Autenticación · Créditos · Parámetros comunes · Códigos de error · openapi.json
GET /alerts
El feed de alertas de este espacio de trabajo — caídas y subidas de posición, palabras clave que entran en los resultados o salen de ellos, competidores que le superan o a los que usted supera, cambios en las fichas de los competidores, pasos de reglas y de la comisión de gestión de Apple Ads, descubrimientos de palabras clave terminados —, de la más reciente a la más antigua, con el número de alertas sin leer. Es el mismo feed que la campana del panel.
| Parámetro | Ubicación | Tipo | Descripción |
|---|---|---|---|
limit | query | number | filas, hasta 500 (50 por defecto) |
curl "https://storelift.net/v1/alerts" \
-H "Authorization: Bearer $STORELIFT_API_KEY"GET /portfolio
El día de hoy en todas las apps del espacio de trabajo, una fila por app: usuarios en directo, usuarios y usuarios nuevos, ingresos por publicidad, ingresos por suscripciones y pruebas, además de los totales de la cartera, las tarjetas por hora y por país y el feed de eventos de suscripción. Son las mismas cifras que la pantalla Hoy del panel. Envíe day para consultar un día anterior.
| Parámetro | Ubicación | Tipo | Descripción |
|---|---|---|---|
tz | query | string | zona horaria IANA para el límite del día, p. ej. Europe/Istanbul (UTC por defecto) |
day | query | string | día anterior en formato YYYY-MM-DD (hoy por defecto) |
curl "https://storelift.net/v1/portfolio" \
-H "Authorization: Bearer $STORELIFT_API_KEY"GET /account
A quién pertenece esta clave o sesión: plan, método de autenticación, ámbitos que lleva, apps que puede leer y saldo de créditos. No consume créditos. Úselo cuando una llamada se haya rechazado por motivos de plan, ámbito o app.
curl "https://storelift.net/v1/account" \
-H "Authorization: Bearer $STORELIFT_API_KEY"Respuesta de ejemplo
GET /usage
Todas las cuotas del espacio de trabajo con lo usado y la hora de reinicio: palabras clave seguidas, apps, descubrimiento, preguntas a la IA, IA de reseñas, visibilidad en IA, espía, créditos de API, la cuota de Hive de hoy y el límite por segundo. No consume créditos. used=null significa que la cuota no se mide en este plan, no que sea cero.
curl "https://storelift.net/v1/usage" \
-H "Authorization: Bearer $STORELIFT_API_KEY"Respuesta de ejemplo
GET /search
Busca en los registros de esta cuenta — nombres de apps e ids de tienda, palabras clave seguidas y las apps competidoras que aparecen por encima del usuario — y devuelve una lista de ids para pasar a fetch. Sirve para localizar un registro; para descubrir apps nuevas en toda la tienda, use find_apps.
| Parámetro | Ubicación | Tipo | Descripción |
|---|---|---|---|
qobligatorio | query | string | texto libre: el nombre de una app, una palabra clave, el nombre de un competidor o un id de tienda |
curl "https://storelift.net/v1/search?q=sleep" \
-H "Authorization: Bearer $STORELIFT_API_KEY"Respuesta de ejemplo
GET /fetch
El registro completo de un id devuelto por search: la tarjeta de una app, una palabra clave seguida con su estado actual y su historial de posiciones, o un competidor con las palabras clave en las que supera al usuario. Devuelve id, title, url, un texto de una línea y metadata.
| Parámetro | Ubicación | Tipo | Descripción |
|---|---|---|---|
idobligatorio | query | string | un id tal como lo devolvió search (app:…, kw:…, rival:…) |
curl "https://storelift.net/v1/fetch?id=kw%3Asbx-lumen%3Aus%3Asleep%2520sounds" \
-H "Authorization: Bearer $STORELIFT_API_KEY"