Apple App Store App Reviews
Las reseñas de apps de Apple App Store son registros públicos de opiniones de clientes, con texto escrito, calificaciones, identidad de quien reseña, momento de publicación y enlaces a la app reseñada. Estos registros sirven para analizar opiniones, comparar calificaciones, enriquecer catálogos de apps y monitorear su evolución en el tiempo.
Funcionalidades de la Apple App Store App Reviews API
- Lotes de URL de apps conocidasEnvíe una o más URL de productos de apps.apple.com en una sola tarea y defina un único results_limit para el total de registros de reseñas guardados a partir de esa solicitud.
- Registros públicos de reseñas normalizadosLea el texto de la reseña, la calificación numérica, la identidad de quien reseña, el contenido multimedia opcional y los campos estables del registro mediante el esquema de reseñas compartido.
- Contexto de la app y de la recopilaciónAsocie cada reseña disponible con el identificador de su sujeto o con la URL de la app, y conserve las marcas de tiempo de publicación y recopilación para obtener instantáneas trazables.
Parámetros de la Apple App Store App Reviews API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | Lista obligatoria de referencias no vacías a apps cuyo nombre de host analizado sea apps.apple.com o un subdominio; se aceptan valores absolutos y relativos al protocolo, separados por comas o saltos de línea en el Playground. |
results_limit | Opcional | Entero positivo opcional de 1 a 2,000 que limita el total de registros de reseñas almacenados para la tarea; el valor predeterminado del backend es 100. |
Cómo usar la Apple App Store App Reviews API
Envíe URL de apps conocidas, siga la tarea asíncrona y recorra por páginas los registros de reseñas almacenados para la tarea completada.
- Prepare al menos una referencia a una app cuyo nombre de host analizado sea apps.apple.com y, si lo desea, elija un results_limit de 1 a 2,000.
- Envíe los datos por POST a /v1/apple-app-store/app-reviews y guarde el task_id devuelto.
- Consulte GET /v1/tasks/{task_id} hasta que el estado sea succeeded o failed.
- Lea data.results.items y continúe con next_cursor mientras has_more sea true.
curl -X POST "https://api.socq.ai/v1/apple-app-store/app-reviews" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://apps.apple.com/us/app/chatgpt/id6448311069"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCasos de uso de la Apple App Store App Reviews API
- Revisión de opiniones sobre apps: Use el texto escrito de las reseñas, los valores de calificación y el contexto de quien reseña para examinar las opiniones públicas devueltas para páginas de apps conocidas.
- Comparación de calificaciones entre apps: Agrupe los registros normalizados por identificador del sujeto o por URL de la app y luego compare las distribuciones de calificaciones entre los productos enviados.
- Instantáneas de la línea de tiempo de reseñas: Conserve las marcas de tiempo de publicación y recopilación junto con los ID de reseña para distinguir los registros recién recopilados de las instantáneas anteriores.
Consejos de expertos para la Apple App Store App Reviews API
- Valide que cada entrada tenga un nombre de host apps.apple.com antes del envío; se aceptan subdominios y referencias relativas al protocolo, mientras que otros hosts se rechazan.
- Elija results_limit para la tarea en conjunto y no por app; las solicitudes que lo omiten usan 100 y el rango aceptado llega hasta 2,000.
- Siga next_cursor solo para leer más resultados almacenados de SocQ; no solicita otra página al proveedor ni continúa la recopilación en origen.
- Trate el texto, los datos del autor, la calificación, las referencias a la app o el contenido multimedia ausentes como desconocidos y omita los campos nulos en las vistas posteriores.
APIs relacionadas
Además de la Apple App Store App Reviews API, use estas APIs cuando necesite otro tipo de datos públicos de Apple App Store.
- Apple App Store App Detail API — Obtiene desde URLs conocidas de fichas de la App Store la identidad pública normalizada de la app, los metadatos descriptivos, el contexto del desarrollador y la categoría, las calificaciones visibles, el precio y el contenido multimedia.
- Apple App Store Rankings API — Recolecta entradas de clasificaciones por categoría desde URLs compatibles de la Apple App Store, con posición de origen, identidad de la app, desarrollador, calificación, cantidad de reseñas, precio y contenido multimedia.