Google Play App Detail
Los detalles de apps de Google Play son registros públicos de fichas de la tienda, con la identidad de la aplicación, las descripciones, el contexto del desarrollador y de la categoría, las calificaciones y cantidades de reseñas visibles, los rangos de instalaciones, el precio y el contenido multimedia. Estos campos sirven para enriquecer catálogos, comparar apps seleccionadas y monitorear en momentos concretos.
Funcionalidades de la Google Play App Detail API
- Límite de lotes de URL conocidasEnvíe una o más URL de apps de play.google.com para una consulta directa de detalles, sin convertir la solicitud en un descubrimiento por palabra clave.
- Identidad y texto de la fichaNormaliza el identificador del paquete, el nombre de la app, la descripción pública de la tienda, el desarrollador, la categoría, la URL de origen y el momento de recopilación.
- Contexto de mercado visibleConserva los campos disponibles de calificación, cantidad de reseñas, rango de instalaciones, precio y posición como observaciones que pueden ser nulas, tomadas de la ficha pública.
- Registros de apps con contenido multimediaDevuelve el contenido multimedia junto con un esquema de app estable, para que los registros de fichas sigan el mismo flujo asíncrono de resultados que el resto de los datos de SocQ.
Parámetros de la Google Play App Detail API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | Lista obligatoria y no vacía de cadenas con URL de apps conocidas cuyo nombre de host analizado sea play.google.com o un subdominio. Cada URL aceptada es una consulta de detalle. |
Cómo usar la Google Play App Detail API
Envíe URL conocidas de Google Play, siga la tarea asíncrona y lea los registros de apps normalizados una vez completada.
- Prepare una lista urls no vacía con enlaces de apps cuyo nombre de host analizado sea play.google.com o un subdominio compatible.
- Envíe la lista por POST a /v1/google-play/app-detail y guarde el task_id devuelto.
- Consulte /v1/tasks/{task_id} hasta que la tarea se complete con éxito o falle.
- Tras el éxito, lea data.results.items. Siga next_cursor solo cuando has_more sea true; recorre registros que SocQ ya almacenó y no descubre otra página de origen de Google Play.
curl -X POST "https://api.socq.ai/v1/google-play/app-detail" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://play.google.com/store/apps/details?id=com.openai.chatgpt"]}'
# Poll GET /v1/tasks/{task_id}
# Read normalized app records from data.results.itemsCasos de uso de la Google Play App Detail API
- Enriquecer un catálogo de apps conocido: Convierta enlaces almacenados de Google Play en ID de paquete, títulos, descripciones, desarrolladores, categorías, URL de origen y marcas de tiempo de recopilación normalizados.
- Comparar fichas seleccionadas: Alinee los campos disponibles de calificación, cantidad de reseñas, rango de instalaciones, precio, categoría y contenido multimedia en un conjunto aprobado de URL de apps.
- Monitorear instantáneas de fichas: Repita las consultas según un calendario definido y compare los campos de la ficha que pueden ser nulos con collected_at para identificar cambios en momentos concretos.
Consejos de expertos para la Google Play App Detail API
- Use URL completas de apps de Google Play y elimine los duplicados de la lista antes del envío, para que la estimación refleje consultas intencionales.
- Trate cada URL de entrada como apta para producir como máximo un resultado y alinee los registros devueltos por url o app_id, porque una URL aceptada aún puede no resolverse en ningún elemento.
- Almacene de forma defensiva la calificación, la cantidad de reseñas, el rango de instalaciones, el precio, la posición y el contenido multimedia, porque los campos públicos de la ficha pueden estar ausentes o cambiar después de la recopilación.
- Use next_cursor solo para seguir leyendo los resultados almacenados de SocQ de una tarea completada; este endpoint de detalle no expone la búsqueda de Google Play ni paginación de páginas de origen.
APIs relacionadas
Además de la Google Play App Detail API, use estas APIs cuando necesite otro tipo de datos públicos de Google Play.
- Google Play App Rankings API
- 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.