Google Play App Rankings
La URL de una lista de Google Play identifica la categoría o la superficie de clasificación que se recopila, mientras que results_limit controla la profundidad del descubrimiento, de 1 a 2000 registros. Cada resultado almacenado sigue el contrato AppItem, de modo que la posición se puede analizar junto con la identidad del paquete, el desarrollador, la categoría, la calificación, la cantidad de reseñas, las instalaciones, el precio, el contenido multimedia, la URL de origen y el momento de recopilación disponibles.
Funcionalidades de la Google Play App Rankings API
- Lotes de URL de listasEnvíe una lista urls no vacía de páginas públicas de categorías o de clasificaciones de play.google.com, en lugar de campos separados de país o categoría.
- Validación de URL de clasificaciones de Google PlayEl entorno de ejecución acepta play.google.com y sus subdominios solo cuando la ruta contiene /store/apps/collection/ o /store/apps/category/.
- Recopilación de clasificaciones acotadaUse results_limit de 1 a 2000. Omítalo para usar 100, que también es la estimación de facturación y el valor predeterminado de descubrimiento del proveedor.
- Posiciones de apps normalizadasLea rank junto con app_id, name, developer, category, rating, reviews_count, installs, price, media y los metadatos públicos de origen disponibles en una sola estructura AppItem.
- Flujo asíncrono de conjuntos de datosLas filas de URL enviadas activan un conjunto de datos asíncrono del proveedor; SocQ almacena los registros normalizados y devuelve el estado de la tarea mediante el lector de tareas compartido.
- Cursor de resultados almacenadosTras el éxito, pagine los registros de SocQ con el next_cursor opaco del lector de tareas y un limit de 1 a 500. Este cursor no es un token de página de Google Play ni del proveedor.
- Liquidación según resultados realesSocQ cobra por adelantado la estimación de resultados solicitada o predeterminada, luego liquida a 0.15 créditos por resultado almacenado y reembolsa los créditos estimados que no se usaron; un resultado vacío se liquida en la base de cero créditos.
Parámetros de la Google Play App Rankings API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | Lista obligatoria y no vacía de URL públicas de clasificaciones de Google Play. Cada URL debe usar play.google.com o uno de sus subdominios y contener /store/apps/collection/ o /store/apps/category/ en su ruta; el entorno de ejecución no acepta country ni category como campos independientes. |
results_limit | Opcional | Entero positivo opcional de 1 a 2000. Su valor predeterminado es 100, limita el descubrimiento y los registros almacenados en toda la tarea, y aporta la estimación de facturación inicial. Las URL de entrada se procesan en orden según la cuota restante de la tarea. |
Cómo usar la Google Play App Rankings API
Envíe una o más URL conocidas de listas de Google Play, siga la tarea asíncrona y lea los registros de clasificación normalizados tras el éxito.
- Elija URL públicas de categorías o clasificaciones de play.google.com cuyo contexto de lista ya codifique el mercado y la superficie de recopilación que necesita.
- Envíe urls y un results_limit opcional por POST a /v1/google-play/app-rankings y guarde el task_id devuelto.
- Consulte /v1/tasks/{task_id} hasta que status sea succeeded o failed; los resultados no están disponibles mientras la tarea esté en cola o en ejecución.
- Lea data.results.items y continúe con next_cursor solo cuando has_more sea true.
curl -X POST "https://api.socq.ai/v1/google-play/app-rankings" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://play.google.com/store/apps/collection/topselling_free"],"results_limit":100}'
# Poll GET /v1/tasks/{task_id}
# Continue with GET /v1/tasks/{task_id}?cursor={next_cursor}&limit=50Casos de uso de la Google Play App Rankings API
- Instantáneas de listas por categoría: Almacene rank y collected_at juntos para comparar instantáneas recopiladas por separado de una lista conocida de Google Play.
- Descubrimiento de apps clasificadas: Convierta un conjunto curado de URL de categorías en registros de apps normalizados para su revisión, etiquetado o enriquecimiento posterior de catálogos.
- Verificación de posiciones del portafolio: Relacione los campos disponibles app_id y developer con un portafolio interno y luego examine cada posición devuelta, sin depender solo de la coincidencia por nombre visible.
- Análisis de la tienda entre ejecuciones: Cargue los campos fijos de AppItem en un almacén de datos para que las calificaciones, cantidades de reseñas, instalaciones, precios y posiciones que pueden ser nulos sigan siendo comparables entre recopilaciones.
Consejos de expertos para la Google Play App Rankings API
- Use la URL pública de una categoría o lista de Google Play, no una página de detalle de app, una frase de búsqueda, un código de país ni una etiqueta de categoría; en esta solicitud solo van urls y results_limit.
- Use una URL de play.google.com cuya ruta contenga /store/apps/collection/ o /store/apps/category/; las páginas de detalle de apps y las rutas no relacionadas no pasan la validación antes de que comience la recopilación.
- Con varias URL de entrada, results_limit se comparte en toda la tarea. Las URL se procesan en orden y cada una recibe solo la cuota restante, así que divida las tareas cuando cada lista necesite una cuota independiente.
- Trate los metadatos de la app como valores que pueden ser nulos. Conserve app_id, url, rank y collected_at cuando estén disponibles, en lugar de suponer que las calificaciones, las cantidades de reseñas, las instalaciones, el precio o el contenido multimedia siempre estarán completos.
- No envíe un cursor de origen. Espere al éxito y luego use solo el next_cursor opaco devuelto dentro de data.results para paginar los registros almacenados de SocQ.
- Calcule el presupuesto a partir de results_limit en el momento del envío. Los créditos finales siguen la cantidad real de resultados almacenados a 0.15 créditos cada uno, y se reembolsan los créditos estimados que no se usaron.
APIs relacionadas
Además de la Google Play App Rankings API, use estas APIs cuando necesite otro tipo de datos públicos de Google Play.
- Google Play App Detail API — Obtiene detalles públicos normalizados de fichas de Google Play desde URLs conocidas de apps, incluyendo identidad, textos de la tienda, desarrollador, categoría, métricas visibles, precio, contenido multimedia y contexto de recolección.
- Google Play App Reviews API — Recolecta reseñas públicas de apps desde URLs de play.google.com con contexto de país opcional, y campos normalizados de texto, autor de la reseña, calificación, hora y referencia a la app.