google-play/
app-reviews

Recopile reseñas públicas de apps de Google Play a partir de URL de apps de play.google.com con contexto de país opcional, y obtenga el texto de la reseña, autores, calificaciones, marcas de tiempo y referencias de la app como registros normalizados.

Google Play App Reviews API

Lotes de URL de apps
Texto y calificaciones de reseñas
Contexto de país
0.15 créditos por resultado
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

Google Play App Reviews

Las reseñas de apps de Google Play son valoraciones públicas de la tienda de aplicaciones que combinan comentarios escritos y calificaciones por estrellas con la identidad de quien reseña, el momento de publicación y la referencia de la app reseñada. Estos registros sirven para investigar opiniones, comparar calificaciones, monitorear lanzamientos y armar conjuntos de datos de reseñas vinculados a su fuente.

Funcionalidades de la Google Play App Reviews API

  • Entrada de URL de varias appsAcepta una o más URL de apps de play.google.com y distribuye la cantidad de reseñas solicitada entre las apps enviadas.
  • Contenido y calificación de la reseñaDevuelve el texto y la calificación numérica de cada reseña disponible en un registro de reseña consistente.
  • Contexto de quien reseña y del momentoConserva la identidad disponible de quien reseña, la referencia de su perfil, el momento de publicación y el momento de recopilación junto con la opinión.
  • Trazabilidad de la app reseñadaVincula las reseñas normalizadas con los identificadores de app y las URL públicas de apps disponibles mediante subject_id y subject_url.

Parámetros de la Google Play App Reviews API

ParámetrosObligatorioDescripción
urlsObligatorioLista obligatoria de una o más URL de apps no vacías en play.google.com o sus subdominios.
countryOpcionalCadena opcional que se pasa a la fuente de reseñas como contexto de país; omítala cuando no se necesite contexto de mercado.
results_limitOpcionalEntero positivo opcional de 1 a 2,000. Su valor predeterminado es 100 y limita el total de resultados almacenados entre todas las URL enviadas.

Cómo usar la Google Play App Reviews API

Envíe URL de apps de Google Play, siga la tarea asíncrona y recorra por páginas los registros normalizados que almacena SocQ.

  1. Prepare una o más URL públicas de apps cuyo nombre de host sea play.google.com o uno de sus subdominios.
  2. Envíe urls por POST con un country y un results_limit opcionales a /v1/google-play/app-reviews y guarde el task_id devuelto.
  3. Consulte /v1/tasks/{task_id} hasta que la tarea se complete con éxito o falle; no envíe otra tarea mientras consulta.
  4. Tras el éxito, lea data.results.items y devuelva next_cursor a la ruta de la tarea mientras has_more sea true.
curl -X POST "https://api.socq.ai/v1/google-play/app-reviews" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://play.google.com/store/apps/details?id=com.example.notes"],"country":"US","results_limit":100}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Casos de uso de la Google Play App Reviews API

  • Investigación de temas de opinión: Use el texto y las calificaciones de las reseñas para preparar un corpus vinculado a su fuente, destinado a codificación cualitativa o a análisis de texto posterior.
  • Comparación de calificaciones y texto: Compare las opiniones escritas con la calificación numérica asociada en páginas públicas de apps seleccionadas.
  • Monitoreo de la línea de tiempo de reseñas: Combine los momentos de publicación y de recopilación para comparar muestras de reseñas recopiladas por separado en torno a los lanzamientos de producto.
  • Enriquecimiento de conjuntos de datos vinculados a apps: Agregue campos de autor, texto, calificación y marca de tiempo a los registros de apps mediante subject_id y subject_url.

Consejos de expertos para la Google Play App Reviews API

  • Use URL públicas completas de apps en play.google.com; otros hosts no pasan la validación de entrada antes de que comience la recopilación.
  • Al enviar varias URL, elija results_limit como un objetivo para toda la tarea, porque la asignación en la fuente se reparte entre las apps de entrada y el almacenamiento final tiene un tope global.
  • Defina country solo cuando el contexto de mercado importe, y mantenga el mismo valor en las recopilaciones repetidas que pretenda comparar.
  • Siga el next_cursor de la respuesta de la tarea para obtener más registros almacenados; es un cursor de resultados de SocQ, no un cursor que acepte la fuente de reseñas.
  • Trate los campos opcionales de quien reseña, de enlaces de origen y de contenido multimedia como valores que pueden ser nulos, en lugar de reemplazar los valores ausentes con valores predeterminados inventados.

Además de la Google Play App Reviews 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 Rankings API

Explorar otras plataformas

Combine los datos de Google Play con datos públicos de otras plataformas sociales compatibles.

Google Play App Reviews API — FAQ

Google Play App Reviews API es una interfaz programática para recopilar reseñas públicas de apps a partir de una o más URL enviadas de apps de Google Play, con contexto de país opcional. Devuelve texto de reseñas, datos de quien reseña, calificaciones, momentos de publicación, contenido multimedia y referencias de la app reseñada, todo normalizado.

urls es una lista obligatoria de URL no vacías cuyo nombre de host sea play.google.com o un subdominio. country es una cadena opcional que se reenvía a la solicitud a la fuente y se puede omitir.

results_limit tiene un valor predeterminado de 100 y acepta enteros de 1 a 2,000. La solicitud a la fuente distribuye la cantidad solicitada entre las URL enviadas, mientras que SocQ limita el total de resultados almacenados de la tarea al límite solicitado.

Un registro normalizado puede contener ID de la reseña, URL de origen, texto, identidad de quien reseña, calificación numérica, momentos de publicación y de recopilación, identificador de la app, URL de la app y referencias multimedia. Los campos opcionales quedan en null o vacíos cuando el resultado público no los proporciona.

No se acepta ningún cursor de origen proporcionado por quien llama. Una vez que la tarea asíncrona se completa con éxito, next_cursor y has_more recorren las filas de resultados que SocQ ya almacenó.

La tarea se estima en 100 resultados cuando se omite results_limit y cuesta 0.15 créditos de SocQ por resultado almacenado. La facturación final usa la cantidad real de resultados, y un resultado vacío exitoso se liquida con el cargo base de cero créditos.