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:
curl -s https://storelift.net/v1/apps \
-H "x-api-key: sl_live_..."Los 27 endpoints
| Endpoint | Qué devuelve |
|---|---|
GET /v1/apps | Las apps que sigue esta cuenta; el id de las demás llamadas sale de aquí. |
GET | Una app más la instantánea de la última ejecución. |
GET | Posición actual por palabra clave seguida en un storefront, con el estado de medición y la profundidad buscada. |
GET | Las apps que tiene por encima, cada una con los términos en que le supera y ambas posiciones. |
GET | Si un asistente menciona su app para su categoría, con la serie almacenada. Requiere Pro, Studio o Enterprise. |
GET | La serie de posiciones por palabra clave, recortada a la ventana de historial del plan. |
GET | Su propia ficha tal como la sirve la tienda, en ambas plataformas, más los cambios fechados detectados en ella. |
GET | Reseñ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 | Cambios 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 | Tarjetas 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 | Posición en la lista top del género y el storefront de la app, con la serie. |
GET | Ingresos 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 | Recuentos de eventos de suscripción del webhook de RevenueCat / Adapty, por día, país y cohorte mensual. Permiso revenue:read. |
GET | Impresiones → 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 | Precios 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 | Las 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 hastasearchDepth.measured: false: la búsqueda no pudo ejecutarse ese día. No se sabe nada de la posición.
{
"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.
| Endpoint | Qué devuelve |
|---|---|
GET /v1/account | A quién pertenece la clave: plan, método de autenticación, permisos, apps legibles y saldo de créditos. |
GET /v1/usage | Cada cuota con usado / límite / reinicio, el cupo de Hive de hoy y la tasa por segundo. |
GET | Busca en sus propias apps, palabras clave seguidas y rivales; devuelve ids para /v1/fetch. |
GET | 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.
| Endpoint | Qué devuelve | Permiso |
|---|---|---|
GET | La lista Top Free, Top Grossing o iPad de un storefront (100 puestos) a fecha del día más reciente. | hive:read |
GET | 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 | Quién se posicionó para una palabra clave, día a día (1,000 filas por llamada). | hive:read |
GET | Las palabras clave en las que se posiciona un rival, con el mismo cupo mensual de espionaje que el panel. | hive:spy |
GET | Ingresos y descargas mensuales de cualquier app del App Store, en todo el mundo (202 mientras se hace la primera lectura). | hive:estimate |
GET | 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 | 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 | 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 | 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 | 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 | 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 | 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 | 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.
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/actionsdevuelve 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/confirmlo 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 devuelveconfirm_token_mismatchy 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 sensiblesrevenue: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.
historyychartsusan ambos la ventana del plan.
Errores
| Estado | error | Cuándo |
|---|---|---|
| 401 | missing_api_key | No hay clave en la solicitud. |
| 401 | invalid_api_key | La clave es desconocida o se revocó. |
| 401 | account_deleted | La cuenta asociada a la clave ya no existe. |
| 403 | plan_required | El plan no incluye acceso a la API. |
| 405 | method_not_allowed | Las lecturas son GET; POST se acepta en /v1/actions, /v1 y /v1 (el borrador va en el cuerpo). |
| 400 | unknown_action | El nombre de la acción no está en el catálogo; la respuesta enumera las que sí están. |
| 400 | invalid_arguments | Falta un argumento o tiene un formato incorrecto; la respuesta nombra el campo. |
| 409 | confirm_token_expired | El token tiene más de 10 minutos. Vuelva a previsualizar. |
| 409 | confirm_token_mismatch | El objetivo cambió después de la vista previa; la respuesta lleva el nuevo diff. |
| 403 | write_limit_reached | La escritura queda fuera de las salvaguardas (paso de presupuesto, número de acciones diarias). |
| 403 | test_key_read_only | Las claves de prueba nunca escriben. |
| 404 | job_not_found | No hay ningún trabajo con ese id en este espacio de trabajo. |
| 403 | workspace_suspended | El espacio de trabajo está suspendido; soporte puede decirle por qué. |
| 403 | ip_list_required | Este espacio de trabajo exige que cada clave lleve una lista de IP permitidas. |
| 404 | not_found | Ese id de app no está en esta cuenta. |
| 404 | unknown_endpoint | No existe esa ruta bajo /v1. |
| 402 | credits_exhausted | Los créditos de este mes se han agotado; la respuesta enlaza al paquete de créditos. |
| 429 | rate_limited | Demasiadas solicitudes para esta clave; espere los segundos de Retry-After. |
| 429 | daily_hive_limit | El cupo de Hive de hoy para el plan se ha agotado; se reinicia a las 00:00 UTC. |
| 404 | not_measured | No 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. |
| 400 | bad_query | /v1/search necesita q de 1 a 120 caracteres. |
| 400 | bad_id | /v1/fetch necesita un id exactamente como lo devolvió /v1/search. |
| 403 | asc_required | update_listing necesita una clave de App Store Connect conectada. |
| 403 | asc_role | La clave de App Store Connect necesita el rol Admin o App Manager para editar metadatos. |
| 409 | no_editable_version | No hay ninguna versión del App Store editable; la respuesta enumera los estados actuales de las versiones. |
| 404 | locale_not_found | Ese idioma del storefront no está en la versión; la respuesta enumera los que sí están. |
| 409 | changed_since_preview | La ficha cambió en App Store Connect después de la vista previa; no se escribió nada. |
| 422 | asc_rejected | App Store Connect rechazó el cambio; su propio mensaje está en detail. |
| 409 | in_progress | Todavía se está ejecutando una escritura sobre el mismo objetivo. |
| 403 | ip_not_allowed | La clave tiene una lista de IP permitidas y esta solicitud llegó desde otra dirección. |
| 401 | key_leaked | La 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 →
