Endpoints de Hive

GET /rank-check

La posición en directo de una de sus apps para cualquier término de búsqueda en una tienda, tal como la tienda la muestra ahora mismo; no hace falta seguir el término. El estado distingue los casos: ranked, con la posición y las apps justo por encima; absent, con los primeros resultados (la app se vende allí y queda fuera de esos resultados); not_in_store (la app no se vende en esa tienda).

Scope

apps:read

Créditos

10

Plan

Free

curl "https://storelift.net/v1/rank-check?app=us&term=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET /keyword-difficulty

Datos de demanda y dificultad de un término de búsqueda de App Store en una tienda: su demanda (demand) y las búsquedas relacionadas, los primeros resultados con su número de valoraciones y si el término está en su título, el número de valoraciones más alto y la mediana entre ellos, y la profundidad de los resultados. thin marca un término con menos de diez resultados; zayifEslesme marca un término que la tienda relaciona de forma aproximada. Free lee los términos que la cuenta sigue en esa tienda; Pro y superiores leen cualquier término.

Scope

apps:read

Créditos

10

Plan

Free

curl "https://storelift.net/v1/keyword-difficulty?term=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET /hive/find

Busca apps en las listas de éxitos que medimos: filtre por categoría, tienda, lista (Top ingresos, Top gratis, Top de pago o Top iPad), rango de posiciones, fecha de primera aparición, nombre o editor, y por ingresos mensuales, descargas mensuales o crecimiento a 30 días. Envíe estimates: true para recibir los ingresos y las descargas mensuales de cada fila desde Hive, una cifra para cada uno, con el día de la cifra. Cuando hay un filtro de ingresos, descargas o crecimiento, las apps para las que Hive aún no tiene cifra quedan fuera y se cuentan en noEstimate. 20 créditos por la lista; con cifras, o con un filtro de ingresos, descargas o crecimiento, 50 más por fila devuelta. La respuesta incluye coverage, el día en que empieza el índice de primeras apariciones, así que cada fecha que lea es un día que indexamos.

Scope

hive:read

Créditos

20

Plan

Hive Explorer

curl "https://storelift.net/v1/hive/find?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET /hive/charts

Una lista de éxitos tal como la medimos por última vez: los ids de las apps en orden para una tienda, un tipo de lista y una categoría opcional, con el día en que se leyó. Envíe estimates: true para recibir el valor mensual de cada puesto (ingresos en Top ingresos, descargas en Top gratis) y lo que hace falta para entrar en los puestos 10, 50 y 100. 10 créditos por la lista; con estimates, 50 más por fila devuelta. Solo App Store: Google Play no tiene una lista de éxitos pública, y una cifra allí sería inventada.

Scope

hive:read

Créditos

10

Plan

Hive Explorer

También admite: country

curl "https://storelift.net/v1/hive/charts?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

Abrir en el sandbox

GET /hive/movers

Quién subió, quién bajó, quién entró y quién salió de una lista de éxitos, frente a la misma lista de hace N días. measured indica que el día de comparación está disponible, así que cada variación que lea queda entre dos días medidos; las apps que salieron llevan su última posición en lugar de una variación, porque hoy están fuera de la lista.

Scope

hive:read

Créditos

10

Plan

Hive Explorer

También admite: country

curl "https://storelift.net/v1/hive/movers?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET /hive/new

Apps vistas por primera vez en una lista de éxitos, de la más reciente a la más antigua, con el editor de cada una. daysCovered indica cuántos de los días solicitados contiene el índice, así que cada fecha de primera aparición que lea es un día que indexamos.

Scope

hive:read

Créditos

10

Plan

Hive Explorer

curl "https://storelift.net/v1/hive/new?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET /hive/publisher/{publisherId}

Todas las apps de un editor que hemos visto en una lista, con el día en que se vio cada una por primera vez. Las apps del editor que nunca entraron en una lista no están aquí: enumeramos lo que medimos, no todo lo que existe.

Scope

hive:read

Créditos

10

Plan

Hive Explorer

curl "https://storelift.net/v1/hive/publisher/1000000900" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET /hive/resolve

Encuentra el id de cualquier app: por nombre o desarrollador (los mejores resultados en esa tienda, con editor, categoría, valoración y número de valoraciones), o a partir de un enlace de App Store / Google Play, un id de App Store o un nombre de paquete. Úselo antes de hive_app_details, hive_similar_apps o hive_app_reviews cuando solo tenga un nombre.

Scope

hive:read

Créditos

10

Plan

Hive Explorer

También admite: country

curl "https://storelift.net/v1/hive/resolve?q=sleep&country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET /hive/similar/{appId}

El estante de apps similares de la propia tienda para cualquier app (You Might Also Like de Apple, Similar apps de Google), en el orden del estante, con la categoría, el nombre y el editor de cada app y el día en que se leyó el estante. Las categorías del estante muestran en qué grupo sitúa la tienda a la app.

Scope

hive:read

Créditos

10

Plan

Hive Explorer

curl "https://storelift.net/v1/hive/similar/sbx-lumen?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET /hive/reviews/{appId}

Las reseñas recientes de cualquier app en una tienda, de la más reciente a la más antigua: estrellas, título, texto, versión y fecha, además de la distribución de estrellas de las filas devueltas. No se incluyen los nombres de quienes escriben las reseñas. Una app que Hive aún no tiene se incorpora en la primera llamada.

Scope

hive:read

Créditos

10

Plan

Hive Explorer

También admite: country

curl "https://storelift.net/v1/hive/reviews/sbx-lumen?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

POST /hive/keywords/{term}/metrics/measure

Inicia una medición de la popularidad o la dificultad de una palabra clave (o de ambas) en una tienda cuando el valor guardado falta o está desactualizado. Un valor reciente o una ausencia verificada se devuelven sin trabajo nuevo; una solicitud que se une a un trabajo ya en curso no consume ninguna unidad de medición diaria; la solicitud que inicia un trabajo nuevo consume una de la cuota diaria de mediciones de Hive del espacio de trabajo. Las dos métricas son independientes: si una fuente falla, la otra métrica válida permanece en la respuesta. wait (0–20 segundos) mantiene la llamada abierta hasta que se guarda el resultado; 202 significa que sigue en curso: léalo más tarde con hive_keyword_metrics. Requiere el ámbito opcional hive:measure: elegido en la clave de API o aprobado por separado al conectar mediante OAuth. Solo iOS.

Scope

hive:measure

Créditos

50

Plan

Hive Explorer

Iniciar un trabajo nuevo consume una medición de la cuota diaria de mediciones de Hive del espacio de trabajo, así que aquí no hay ningún comando para copiar.

Cuerpo de la petición

{"country":"us","platform":"ios","metrics":["popularity","difficulty"],"wait":15}

GET /hive/apps/{id}

Los datos de la tienda que la red midió para cualquier app en su último día: nombre, número de valoraciones, valoración, versión, precio, distribución, insignia y número de compras in-app. En apps de App Store, listingExtras añade los idiomas admitidos, el reparto de estrellas (de 1★ a 5★), los eventos in-app en curso y próximos, el texto promocional y las compras in-app destacadas, con su propio measuredAt; es null si no se midió. not_measured indica las tiendas a las que añadir la app.

Scope

hive:read

Créditos

10

Plan

Hive Explorer

También admite: country

curl "https://storelift.net/v1/hive/apps/1000000001?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

Abrir en el sandbox

GET /hive/keywords/{term}/ranks

Los primeros resultados de cualquier palabra clave que mide la red, por día. days se reduce cuando top es grande para que una llamada no pase de 1000 filas. 10 créditos hasta 7 días, 20 hasta 30 y 40 hasta 90.

Scope

hive:read

Créditos

10

Plan

Hive Explorer

También admite: country · platform

curl "https://storelift.net/v1/hive/keywords/sleep/ranks?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

Abrir en el sandbox

GET /hive/keywords/{term}/metrics

Lee las observaciones de Hive existentes para una palabra clave exacta y una tienda. La popularidad es un entero de 1 a 100; la dificultad es una puntuación de 0 a 100. Los datos que faltan permanecen como null. Cada métrica lleva su propia evidencia, la hora de la fuente, su vigencia y el estado del último intento. Este GET nunca inicia una solicitud a la fuente ni un trabajo de medición. Requiere el producto Hive Explorer completo; Android no es compatible, y así se indica explícitamente.

Scope

hive:read

Créditos

10

Plan

Hive Explorer

También admite: country

curl "https://storelift.net/v1/hive/keywords/sleep/metrics?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

Abrir en el sandbox

GET /hive/keywords/{term}/metrics/history

Lee el historial diario guardado de una palabra clave: los resultados de búsqueda, la puntuación de dificultad y la popularidad de Apple registrados cada día. Los valores de dificultad anteriores se conservan tal como se registraron. Los días fallidos o incompletos se marcan como tales; un día sin registro guardado no es un cero ni una ausencia verificada. Siga pagination.nextCursor con la misma palabra clave, tienda y días. Cada serie se pagina por separado, con hasta 200 registros por página. Este GET solo lee el historial guardado y nunca inicia una medición. Requiere el producto Hive Explorer completo; Android no es compatible, y así se indica explícitamente. 10 créditos hasta 7 días, 20 hasta 30 y 40 hasta 90.

Scope

hive:read

Créditos

20

Plan

Hive Explorer

También admite: country

curl "https://storelift.net/v1/hive/keywords/sleep/metrics/history?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

Abrir en el sandbox

GET /hive/spy/{id}

Todas las palabras clave en las que la red midió una app, con su posición. Cada llamada se paga en créditos; una app sin palabras clave que mostrar cuesta 1.

Scope

hive:spy

Créditos

200

Plan

Hive Explorer

También admite: country · platform

curl "https://storelift.net/v1/hive/spy/1000000104?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

Abrir en el sandbox

GET /hive/estimate/{id}

Ingresos y descargas mensuales de cualquier app de App Store, en todo el mundo: una cifra para cada uno (value, o under cuando la app está por debajo de ese importe) y cuántos mercados cubre. Todas las apps reciben respuesta. Hive ya las conoce. La primera solicitud de una app inicia la lectura y responde 202 con eta segundos. 500 créditos por las cifras; una respuesta pendiente cuesta 1.

Scope

hive:estimate

Créditos

500

Plan

Hive Explorer

También admite: country

curl "https://storelift.net/v1/hive/estimate/1000000001?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

Abrir en el sandbox

GET /hive/gap

Las listas de palabras clave de hasta 5 apps, lado a lado, una fila por palabra clave: la posición de cada app, cuántas la tienen y cuáles faltan. 200 créditos por app comparada; una app fuera del índice no se cobra. Forma parte de Explorer.

Scope

hive:spy

Créditos

400

Plan

Hive Explorer

También admite: country · platform

curl "https://storelift.net/v1/hive/gap?ids=1000000001,1000000104&country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET /hive/research

Escriba una palabra clave semilla y reciba términos de búsqueda de App Store relacionados, cada uno con la popularidad de Apple (1–100 cuando se ha observado; los valores que faltan permanecen como null), la dificultad (0–100), cuántas apps posicionan para él y las 10 primeras apps. La evidencia de cada métrica distingue entre un valor medido, una ausencia verificada, un trabajo pendiente y errores de la fuente. Las filas con una medición activa llevan state: "pending"; repita la solicitud para leer el resultado. Cuando el App Store corrige la ortografía de un término, la fila incluye spell con la búsqueda corregida. No hace falta ninguna app. Forma parte de Explorer.

Scope

hive:read

Créditos

50

Plan

Hive Explorer

También admite: country

curl "https://storelift.net/v1/hive/research?seed=us&country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET /hive/landscape

El panorama de categorías de una tienda a partir de su lista de apps gratuitas: el muro de valoraciones del top 10, la mediana de valoración, la longitud del nombre, la antigüedad de lanzamientos y actualizaciones, los idiomas, el tamaño y los editores con varias apps. Cada categoría lleva su propio día de medición.

Scope

hive:read

Créditos

10

Plan

Hive Explorer

También admite: country

curl "https://storelift.net/v1/hive/landscape?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"