apple-app-store/
app-reviews

Recopile reseñas públicas de Apple App Store a partir de una o más URL de apps.apple.com y obtenga el texto de la reseña, calificaciones, datos de quien reseña, marcas de tiempo y contexto de la app como registros normalizados.

Apple App Store App Reviews API

URL de apps conocidas
Texto y calificaciones públicos de reseñas
Contexto de quien reseña y de la app
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

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ámetrosObligatorioDescripción
urlsObligatorioLista 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_limitOpcionalEntero 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.

  1. 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.
  2. Envíe los datos por POST a /v1/apple-app-store/app-reviews y guarde el task_id devuelto.
  3. Consulte GET /v1/tasks/{task_id} hasta que el estado sea succeeded o failed.
  4. 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 true

Casos 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.

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.

Explorar otras plataformas

Combine los datos de Apple App Store con datos públicos de otras plataformas sociales compatibles.

Apple App Store App Reviews API — FAQ

Apple App Store App Reviews API es una interfaz programática para recopilar reseñas públicas de clientes a partir de URL conocidas de apps de Apple App Store. Devuelve texto de reseñas, calificaciones, datos de quien reseña, marcas de tiempo, contenido multimedia y referencias a la app cuando están disponibles, todo normalizado.

urls es obligatorio y debe contener una o más referencias no vacías cuyo nombre de host analizado sea apps.apple.com o un subdominio; se aceptan formas absolutas y relativas al protocolo. results_limit es opcional, su valor predeterminado es 100 y acepta enteros de 1 a 2,000.

No. results_limit limita el total de registros almacenados para la tarea entre toda la lista de URL enviadas, así que si necesita límites independientes, divida los objetivos de recopilación en tareas distintas.

No. next_cursor recorre los registros que SocQ ya almacenó una vez que la tarea se completa con éxito; la solicitud pública no expone un cursor del proveedor para obtener más páginas en origen.

Cada reseña almacenada con éxito cuesta 0.15 créditos de SocQ, con una estimación de 100 resultados cuando se omite results_limit. Una tarea sin reseñas almacenadas no genera cargo por resultado, porque el cargo base configurado es cero.