Storelift

Storelift › Guías › La API de Storelift

Capa de IA

La API de Storelift

Todo lo que muestra el panel es también un endpoint JSON. 27 endpoints GET leen sus apps seguidas y el mercado, y POST /v1/actions previsualiza un cambio que luego aplica POST /v1/actions/confirm; así, un script, una hoja de cálculo o un paso de CI leen los mismos números y actúan sobre ellos. La referencia completa está en /docs/api/ y la especificación legible por máquina en /openapi.json (OpenAPI 3.1); para un asistente, el servidor MCP, incluido desde Pro.

Empezar gratis →Plan gratuito: 1 app, 10 palabras clave en cada una de 2 tiendas, 14 días de historial, sin tarjeta y sin fecha de fin. Pro cuesta $29/mes.

Por Actualizado: 10 min de lectura

Seguimiento de palabras clave · historial de posiciones, movimientos de la semana y palabras clave seguidas

Dirección base y autenticación

La base es https://storelift.net/v1. Cree una clave en Settings → API; se muestra una sola vez y solo se guarda como hash, así que una clave perdida se sustituye, no se recupera.

Envíela como x-api-key, o como token bearer si su cliente solo maneja cabeceras Authorization:

Terminal
curl -s https://storelift.net/v1/apps \
  -H "x-api-key: sl_live_..."
El acceso a la API está en los planes Pro y Studio: desde $29 al mes, $99 en Studio. La clave se conserva si baja de plan, así que al volver a subir se reactiva la misma integración.

Los 27 endpoints

EndpointQué devuelve
GET /v1/appsLas apps que sigue esta cuenta; el id de las demás llamadas sale de aquí.
GET /v1/apps/{id}Una app más la instantánea de la última ejecución.
GET /v1/apps/{id}/keywordsPosición actual por palabra clave seguida en un storefront, con el estado de medición y la profundidad buscada.
GET /v1/apps/{id}/rivalsLas apps que tiene por encima, cada una con los términos en que le supera y ambas posiciones.
GET /v1/apps/{id}/aiSi un asistente menciona su app para su categoría, con la serie almacenada. Requiere Pro, Studio o Enterprise.
GET /v1/apps/{id}/historyLa serie de posiciones por palabra clave, recortada a la ventana de historial del plan.
GET /v1/apps/{id}/pageSu propia ficha tal como la sirve la tienda, en ambas plataformas, más los cambios fechados detectados en ella.
GET /v1/apps/{id}/reviewsReseñas recientes con el resumen de estrellas, cuántas son nuevas en esta ejecución y la parte de Play cuando se mide. /reviews/search busca en todo el archivo por texto, estrellas, versión y fechas; /reviews/stats da la distribución, la curva diaria y el desglose por versión.
GET /v1/apps/{id}/timelineCambios fechados de la ficha —versión, capturas, eventos, destacados, cambios en el campo de palabras clave—, cada uno con el movimiento de posiciones de palabras clave a su alrededor.
GET /v1/apps/{id}/featuringTarjetas editoriales, In-App Events y la estantería «También te puede gustar» de Apple por país, con el historial fechado de destacados y eventos nuevos.
GET /v1/apps/{id}/chartsPosición en la lista top del género y el storefront de la app, con la serie.
GET /v1/apps/{id}/revenueIngresos y descargas de la app desde las fuentes conectadas: unidades de App Store Connect, instalaciones de Google Play, MRR, suscripciones y pruebas de RevenueCat. connected:false cuando no hay nada conectado. Permiso revenue:read.
GET /v1/apps/{id}/subscriptionsRecuentos de eventos de suscripción del webhook de RevenueCat / Adapty, por día, país y cohorte mensual. Permiso revenue:read.
GET /v1/apps/{id}/funnelImpresiones → visitas a la página del producto → descargas en el App Store: el punto de hoy y el historial día a día de la analítica de App Store Connect. Permiso revenue:read.
GET /v1/apps/{id}/pricingPrecios vigentes por producto y país y cada periodo de precio fijo con sus pruebas, altas de pago e ingresos, además de los códigos de oferta, desde el webhook de RevenueCat / Adapty. Permiso revenue:read.
GET /v1/apps/{id}/campaignsLas campañas de Apple Ads que promocionan la app (emparejadas por id del App Store): gasto, toques, instalaciones, presupuesto y estado, más las principales palabras clave y términos de búsqueda. Permiso ads:read.

Los endpoints por debajo de /apps/{id} aceptan country (un código de storefront como us; por defecto, el primero de la app) y, donde se miden ambas tiendas, platform=ios|android.

Los tres estados de medición se conservan al cruzar el límite

Un campo de posición puede ser un número, pero la ausencia de un número son dos cosas distintas y la API las mantiene separadas:

  • measured: true, rank: 7: la app se encontró en la posición 7.
  • measured: true, rank: null: la búsqueda se ejecutó y la app no estaba en los resultados hasta searchDepth.
  • measured: false: la búsqueda no pudo ejecutarse ese día. No se sabe nada de la posición.
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 }
  ]
}

Juntar los dos últimos en un cero describiría un desplome que nunca ocurrió, y cualquier promedio construido encima sería erróneo. Si su código necesita un solo número, trate measured: false como un hueco en la serie, no como un valor.

Cuenta, uso y búsqueda

Cuatro endpoints sobre la propia clave y los registros de la cuenta. Los dos primeros no cuestan nada. search y fetch siguen el formato que ChatGPT espera de un conector de investigación profunda: una consulta devuelve ids y un id devuelve el registro.

EndpointQué devuelve
GET /v1/accountA quién pertenece la clave: plan, método de autenticación, permisos, apps legibles y saldo de créditos.
GET /v1/usageCada cuota con usado / límite / reinicio, el cupo de Hive de hoy y la tasa por segundo.
GET /v1/search?q=Busca en sus propias apps, palabras clave seguidas y rivales; devuelve ids para /v1/fetch.
GET /v1/fetch?id=El registro completo detrás de un id de búsqueda: ficha de la app, una palabra clave con su historial o un rival con los términos en que le supera.

Hive: cualquier app, cualquier mercado

Los endpoints anteriores leen sus propias apps seguidas. Los endpoints de Hive leen lo que mide toda la red: listas, la medición diaria de cualquier app, listas de resultados por palabra clave, las palabras clave de un rival y los ingresos y descargas de cualquier app. Necesitan su propio permiso en la clave y cuestan más créditos por llamada; además, cada plan tiene un cupo diario de Hive para que los créditos de un mes duren el mes.

EndpointQué devuelvePermiso
GET /v1/hive/charts?country=&kind=&genre=La lista Top Free, Top Grossing o iPad de un storefront (100 puestos) a fecha del día más reciente.hive:read
GET /v1/hive/apps/{storeId}?country=La última medición diaria de cualquier app: valoraciones, nota, versión, precio, distribución de estrellas e insignia de categoría, además de idiomas admitidos, próximos eventos in-app, texto promocional y compras in-app destacadas.hive:read
GET /v1/hive/keywords/{term}/ranks?country=&days=&top=Quién se posicionó para una palabra clave, día a día (1,000 filas por llamada).hive:read
GET /v1/hive/spy/{storeId}?country=Las palabras clave en las que se posiciona un rival, con el mismo cupo mensual de espionaje que el panel.hive:spy
GET /v1/hive/estimate/{storeId}?country=Ingresos y descargas mensuales de cualquier app del App Store, en todo el mundo (202 mientras se hace la primera lectura).hive:estimate
GET /v1/hive/movers?country=&kind=&genre=&days=&limit=Quién subió, quién bajó, quién entró y quién salió de una lista top, frente a la misma lista hace N días. Cada diferencia se traza entre dos días medidos, y la respuesta nombra ambos.hive:read
GET /v1/hive/new?days=&country=&limit=Apps vistas en una lista top por primera vez, de la más reciente a la más antigua. La respuesta indica cuántos de esos días cubre el índice.hive:read
GET /v1/hive/find?genre=&country=&kind=&released=&rankMin=&rankMax=&text=&publisher=&page=Encuentra apps en las listas que medimos: filtre por categoría, storefront, lista (Top Grossing, Top Free, Top Paid, Top iPad), franja de posición, fecha de primera aparición, nombre o editor. Cada fila lleva los ingresos y las descargas de la app.hive:read
GET /v1/hive/gap?ids=&country=&platform=Brecha de palabras clave de hasta cinco apps lado a lado: en qué término se posiciona cada una y cuál le falta. Hive Explorer. Cada app lleva su propio estado de medición.hive:spy
GET /v1/hive/publisher/{publisherId}Cada app de un editor que Hive ha visto, con el día en que entró por primera vez en una lista.hive:read
GET /v1/hive/resolve?q=&country=&limit=El id de cualquier app a partir de nombre, desarrollador, enlace de tienda, id de App Store o nombre de paquete. Los nombres pasan por la búsqueda de la App Store de esa tienda.hive:read
GET /v1/hive/similar/{storeId}?country=La estantería de apps similares de la tienda para cualquier app, en su orden, con la categoría y el nombre de cada una y el día de lectura.hive:read
GET /v1/hive/reviews/{storeId}?country=&limit=Las reseñas recientes de cualquier app en una tienda con la distribución de estrellas; sin nombres de autores.hive:read

Nada personal cruza esta línea: los autores de las reseñas nunca aparecen, y una palabra clave de un rival solo se muestra cuando la siguen al menos otras dos cuentas o la sigue usted.

Pruébela sin clave

Cada ruta existe también bajo /v1/sandbox/ sin ninguna clave: las mismas formas, un conjunto de datos fijo de dos apps y fechas que se mueven con el día de ayer. Las respuestas llevan x-sandbox: true. Para CI puede crear una clave de prueba (sl_test_) en Settings: solo responde desde el sandbox, no gasta créditos y funciona en todos los planes.

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'

Cómo funcionan las escrituras y los permisos

  • Cada escritura se previsualiza primero. POST /v1/actions devuelve el diff de antes y después, el coste en créditos y un token de un solo uso, sin cambiar nada; POST /v1/actions/confirm lo aplica. El token está ligado a la acción, a los argumentos y al estado del objetivo en el momento de la vista previa, así que si el objetivo cambió entretanto la confirmación devuelve confirm_token_mismatch y no escribe nada. Las acciones cubren palabras clave, rivales, apps, enlaces para compartir y respuestas a reseñas (desde Pro) y, en Studio, el texto de la ficha en una versión editable del App Store y pausar, reanudar y el presupuesto diario de Apple Ads. La lista completa está en la referencia.
  • Los permisos de escritura se activan a elección. Cada escritura necesita su permiso (track:write, reports:write, reviews:write, ads:write, listing:write); empiezan desmarcados al crear una clave. La facturación se gestiona en los ajustes de su cuenta.
  • Compruebe la fecha y el estado de la observación. La respuesta puede contener una medición conservada, una ausencia de datos verificada, trabajo pendiente o un error. Repetir la solicitud no actualiza una observación anterior.
  • La capa de ingresos tiene sus propios permisos. Los diez endpoints de crecimiento (revenue, subscriptions, funnel, pricing, change-impact, campaigns, ads-keywords, ads-search-terms, ads-commands, search-popularity) responden a una clave creada con los permisos sensibles revenue:read / ads:read, así que una clave abre los datos de ingresos solo cuando usted lo elige. GA4 está en el panel.
  • El historial sigue al plan. history y charts usan ambos la ventana del plan.

Errores

EstadoerrorCuándo
401missing_api_keyNo hay clave en la solicitud.
401invalid_api_keyLa clave es desconocida o se revocó.
401account_deletedLa cuenta asociada a la clave ya no existe.
403plan_requiredEl plan no incluye acceso a la API.
405method_not_allowedLas lecturas son GET; POST se acepta en /v1/actions, /v1/actions/confirm y /v1/apps/{id}/validate-listing (el borrador va en el cuerpo).
400unknown_actionEl nombre de la acción no está en el catálogo; la respuesta enumera las que sí están.
400invalid_argumentsFalta un argumento o tiene un formato incorrecto; la respuesta nombra el campo.
409confirm_token_expiredEl token tiene más de 10 minutos. Vuelva a previsualizar.
409confirm_token_mismatchEl objetivo cambió después de la vista previa; la respuesta lleva el nuevo diff.
403write_limit_reachedLa escritura queda fuera de las salvaguardas (paso de presupuesto, número de acciones diarias).
403test_key_read_onlyLas claves de prueba nunca escriben.
404job_not_foundNo hay ningún trabajo con ese id en este espacio de trabajo.
403workspace_suspendedEl espacio de trabajo está suspendido; soporte puede decirle por qué.
403ip_list_requiredEste espacio de trabajo exige que cada clave lleve una lista de IP permitidas.
404not_foundEse id de app no está en esta cuenta.
404unknown_endpointNo existe esa ruta bajo /v1.
402credits_exhaustedLos créditos de este mes se han agotado; la respuesta enlaza al paquete de créditos.
429rate_limitedDemasiadas solicitudes para esta clave; espere los segundos de Retry-After.
429daily_hive_limitEl cupo de Hive de hoy para el plan se ha agotado; se reinicia a las 00:00 UTC.
404not_measuredNo hay una observación verificada para la aplicación, palabra clave o alcance solicitados. Los datos ausentes no equivalen a cero. Revise los parámetros de la solicitud y la documentación enlazada para conocer las acciones disponibles.
400bad_query/v1/search necesita q de 1 a 120 caracteres.
400bad_id/v1/fetch necesita un id exactamente como lo devolvió /v1/search.
403asc_requiredupdate_listing necesita una clave de App Store Connect conectada.
403asc_roleLa clave de App Store Connect necesita el rol Admin o App Manager para editar metadatos.
409no_editable_versionNo hay ninguna versión del App Store editable; la respuesta enumera los estados actuales de las versiones.
404locale_not_foundEse idioma del storefront no está en la versión; la respuesta enumera los que sí están.
409changed_since_previewLa ficha cambió en App Store Connect después de la vista previa; no se escribió nada.
422asc_rejectedApp Store Connect rechazó el cambio; su propio mensaje está en detail.
409in_progressTodavía se está ejecutando una escritura sobre el mismo objetivo.
403ip_not_allowedLa clave tiene una lista de IP permitidas y esta solicitud llegó desde otra dirección.
401key_leakedLa clave apareció en un repositorio público y se revocó automáticamente; cree una nueva.

Todos los errores son JSON con un campo error. plan_required devuelve además plan, para que un cliente pueda decir en qué plan está la clave en lugar de adivinarlo.

Preguntas frecuentes

¿Hay un límite de solicitudes?

Sí, por clave: solicitudes por segundo según el plan (429 con Retry-After), una asignación mensual de créditos que se muestra en las cabeceras x-credits-* y un cupo diario de Hive. Cada llamada actualiza además un contador de uso en la clave para que pueda ver en Settings si una clave antigua sigue en uso.

¿Puedo usarla en el plan gratuito?

Las claves de producción para la API empiezan en Pro. El sandbox sin clave y las claves de prueba funcionan en todos los planes, el servidor MCP remoto empieza en Pro, las herramientas gratuitas de este sitio no necesitan cuenta, y el plan gratuito mide una app a diario.

¿API o servidor MCP?

Un script quiere la API: formas fijas, una llamada, ningún modelo de por medio. Un asistente quiere el servidor MCP, porque las herramientas llevan sus propias descripciones y puede elegir la llamada correcta sin que usted escriba la integración. Ambos trabajan sobre las mismas mediciones, y ambos escriben con el mismo paso de vista previa y confirmación.

Compruébelo con su propia app

Pegue el enlace de su app y añada sus palabras clave. Cada día se miden la posición, las apps por encima de usted y la demanda.

Plan gratuito: 1 app, 10 palabras clave en cada una de 2 tiendas, 14 días de historial, sin tarjeta y sin fecha de fin. Pro cuesta $29/mes.

Empezar gratis →
Grupos de competidores · los términos que comparte con un competidor y los que solo tiene él

Siga leyendo