API de Google Play
Busca aplicaciones Android y consulta su ficha o reseñas mediante el nombre de paquete de Google Play. La puntuación, el número de valoraciones, el número de reseñas y el rango de instalaciones son métricas diferentes.
app_id es un package name como com.example.app, no un Apple ID numérico. Una aplicación gratuita puede contener anuncios o compras integradas, y el rango de instalaciones no es un contador exacto de descargas o usuarios activos.
Disponibilidad de la plataforma
- Salud 24 h
- Normal
Últimos 30 días
Funciones disponibles
Cada acción de Google Play, qué hace, su precio y su salud en las últimas 24 horas. Abre una acción para ver sus parámetros, campos de respuesta y ejemplos de código.
| Capacidad | Qué hace | Por 1.000 | Salud en 24 horas |
|---|---|---|---|
Descubrir aplicaciones por nombre o funciónsearch | keyword sirve para descubrir apps; el app_id devuelto identifica después una ficha concreta. | $1.39 por 1.000 solicitudes | Normal |
Consultar una ficha de Google Play por package nameprofile | Pasa en app_id el valor que aparece tras ?id=; country y language, opcionales, eligen la tienda regional y el idioma de la consulta. | $1.39 por 1.000 solicitudes | Normal |
Analizar reseñas y respuestas del desarrolladorreviews | app_id localiza la aplicación y sort admite newest o top_rated. | $1.39 por 1.000 solicitudes | Normal |
Abre una capacidad para ver sus parámetros, campos de respuesta, ejemplos de código y prueba.
¿Qué acepta cada acción de Google Play?
Cada respuesta enlaza una acción ejecutable con sus entradas reales. El significado y los valores permitidos pertenecen a esa acción; un nombre parecido no conserva automáticamente el mismo sentido en otra plataforma.
Las fuentes oficiales se enlazan solo para precisar el término de la plataforma indicado a su lado. No implican autorización ni respaldo y no añaden a EveryInfra funciones del sitio oficial.
| Acción | Obligatorios | Opcionales | Entrega | Límite | Por 1.000 | Campos de respuesta |
|---|---|---|---|---|---|---|
searchDescubrir aplicaciones por nombre o función
| keyword | country, language, page_token | Entrega síncrona | El catálogo declara defaultLimit = 20 y maxLimit = 100 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. Para la siguiente página, devuelve next_page_token como page_token sin cambiar los demás parámetros; cada página es una llamada. Se puede paginar hasta 100 filas. | $1.39 por 1.000 solicitudes | app_id · url · name · summary · description · developer · developer_email · developer_website · score · rating_count · review_count · installs · min_installs · price · is_free · currency · category · content_rating · contains_ads · offers_iap · version · released · updated_at · android_version · icon_url · header_image_url · privacy_policy · platform · screenshots · rating_histogram |
profileConsultar una ficha de Google Play por package name Pasa en | app_id | country, language | Entrega síncrona | — | $1.39 por 1.000 solicitudes | app_id · url · name · summary · description · developer · developer_email · developer_website · score · rating_count · review_count · installs · min_installs · price · is_free · currency · category · content_rating · contains_ads · offers_iap · version · released · updated_at · android_version · icon_url · header_image_url · privacy_policy · platform · screenshots · rating_histogram |
reviewsAnalizar reseñas y respuestas del desarrollador
| app_id | country, language, page_token, sort | Entrega síncrona | El catálogo declara defaultLimit = 40 y maxLimit = 200 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. Para la siguiente página, devuelve next_page_token como page_token sin cambiar los demás parámetros; cada página es una llamada. Se puede paginar hasta 200 filas. | $1.39 por 1.000 solicitudes | id · app_id · text · title · score · author_name · author_avatar_url · thumbs_up · reply_text · reply_at · app_version · language · url · posted_at · platform |
¿Qué significan los parámetros de Google Play search?
keyword sirve para descubrir apps; el app_id devuelto identifica después una ficha concreta. score, rating_count, review_count, installs y min_installs conservan significados distintos.
keywordObligatorio- Término de búsqueda del nombre o propósito de la aplicación en Google Play, por ejemplo
note taking; no es una búsqueda exacta por el nombre del paquete de la aplicación. Para detalles y comentarios, utilizaapp_id. countryOpcional- Código de país o región de la tienda, como
usoes. Determina el catálogo regional consultado; no es el país del desarrollador ni garantiza que una aplicación esté disponible para todas las cuentas de esa región. languageOpcional- Código de idioma de la tienda, como
enoes. Cambia la presentación localizada cuando está disponible, pero no traduce automáticamente el texto original de todas las reseñas. page_tokenOpcional- Token de paginación: devuelve el next_page_token de la respuesta anterior para obtener la siguiente página; omítelo para la primera. Mantén el resto de parámetros sin cambios. Los tokens duran 24 horas y cada página es una llamada.
¿Qué significan los parámetros de Google Play profile?
Pasa en app_id el valor que aparece tras ?id=; country y language, opcionales, eligen la tienda regional y el idioma de la consulta. La respuesta incluye versión, requisito de Android, precio, anuncios, compras integradas y política de privacidad; no acredita cumplimiento legal.
app_idObligatorio- Nombre del paquete de la aplicación de Android, por ejemplo
com.example.app, es decir, el valor después de?id=en el enlace de la Play Store; no es el ID numérico de la Apple App Store. No envíes la URL completa de Play enapp_id, este valor se usará directamente como el nombre del paquete. countryOpcional- Código de país o región de la tienda, como
usoes. Determina el catálogo regional consultado; no es el país del desarrollador ni garantiza que una aplicación esté disponible para todas las cuentas de esa región. languageOpcional- Código de idioma de la tienda, como
enoes. Cambia la presentación localizada cuando está disponible, pero no traduce automáticamente el texto original de todas las reseñas.
¿Qué significan los parámetros de Google Play reviews?
app_id localiza la aplicación y sort admite newest o top_rated. app_version pertenece a la reseña, thumbs_up son votos útiles y reply_text es una respuesta ya publicada; la acción no responde comentarios ni accede a pruebas privadas.
app_idObligatorio- Nombre del paquete de la aplicación de Android, por ejemplo
com.example.app, es decir, el valor después de?id=en el enlace de la Play Store; no es el ID numérico de la Apple App Store. No envíes la URL completa de Play enapp_id, este valor se usará directamente como el nombre del paquete.Google Play: valoraciones, reseñas y respuesta del desarrollador — Google Play explica que una reseña puede actualizarse y asociarse a versión, votos de utilidad y respuesta del desarrollador, con posibles demoras de revisión. Las funciones del Play Console no son capacidades implícitas de EveryInfra. · Consultada countryOpcional- Código de país o región de la tienda, como
usoes. Determina el catálogo regional consultado; no es el país del desarrollador ni garantiza que una aplicación esté disponible para todas las cuentas de esa región. languageOpcional- Código de idioma de la tienda, como
enoes. Cambia la presentación localizada cuando está disponible, pero no traduce automáticamente el texto original de todas las reseñas. page_tokenOpcional- Token de paginación: devuelve el next_page_token de la respuesta anterior para obtener la siguiente página; omítelo para la primera. Mantén el resto de parámetros sin cambios. Los tokens duran 24 horas y cada página es una llamada.
sortOpcional- Orden de los comentarios de la aplicación:
newest(más recientes),top_rated(mejor puntuados); enreviewsel valor predeterminado esnewest. Este parámetro también aparece ensearch/profile, pero no es un filtro para el ranking de búsqueda de aplicaciones ni para la puntuación total de la aplicación.Valores permitidos:newesttop_rated
Cómo usar la API de Google Play
- 01Consulta el catálogo público y elige una acción de la plataforma.
- 02Envía los parámetros platform y action, junto con los campos obligatorios, a POST /api/v1/social.
- 03Procesa el resultado síncrono o consulta el identificador de trabajo cuando la acción se ejecute de forma asíncrona.
- 04Guarda los campos de la respuesta estructurada que necesita tu aplicación.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"google_play","action":"search","params":{"keyword":"<keyword>"}}'
Guías de Google Play
Ejemplos completos y métodos basados en estas acciones. Comprueba primero en esta página las acciones, parámetros y campos actuales; los ejemplos y límites de un artículo no sustituyen al catálogo en vivo.
Cómo monetizar los comentarios de aplicaciones: de la tienda de aplicaciones a la toma de decisiones
¿Cómo transformar los comentarios extraídos en un producto de pago? A partir del análisis de reseñas de la tienda de aplicaciones, analiza tarjetas de evidencia, tickets de soporte, revisiones de versiones, límites de servicio y validación de renovación, en lugar de entregar únicamente puntuaciones de sentimiento y nubes de palabras.
Leer el artículo →Inicio con la API de datos unificada: del directorio de capacidades al primer resultado disponible
Integra datos multiplataforma usando platform, action y params: comprende el directorio de capacidades, completa una solicitud mínima, gestiona tareas asíncronas, resultados parciales y facturación, y establece registros de datos trazables.
Leer el artículo →Preguntas sobre la API de Google Play
¿Cómo llamo a la API de Google Play?
Envía POST /api/v1/social con platform igual a google_play, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.
¿Qué devuelve la API de Google Play?
Devuelve JSON estructurado. Por ejemplo, el esquema de search incluye app_id, name, summary y description. Cada acción tiene su propia lista de campos; que un campo esté declarado no garantiza que todos los registros tengan un valor.
¿Qué matiz de la documentación oficial conviene conservar al usar datos de Google Play?
Google Play explica que una reseña puede actualizarse y asociarse a versión, votos de utilidad y respuesta del desarrollador, con posibles demoras de revisión. Las funciones del Play Console no son capacidades implícitas de EveryInfra.
¿Qué parámetros son obligatorios?
Depende de la acción. search requiere keyword; profile requiere app_id; reviews requiere app_id.
¿Las acciones de Google Play responden de inmediato?
Las acciones marcadas como asíncronas devuelven un identificador de trabajo que se consulta por sondeo. Cualquier otra acción también puede ejecutarse de forma asíncrona: añade "mode": "async" al cuerpo de la solicitud para recibir el identificador de inmediato, útil para tareas lentas o límites altos.