API de App Store Connect: leer y responder reseñas de clientes

English · Deutsch · Polski · Français

La API de App Store Connect expone las reseñas de clientes de tus apps y te deja publicar, sustituir y borrar respuestas. Así funciona, según la documentación de Apple.

Autenticación

Las solicitudes usan un JSON Web Token firmado con una clave de la API de App Store Connect (App Store Connect API: Generating tokens for API requests).

Listar reseñas

GET https://api.appstoreconnect.apple.com/v1/apps/{id}/customerReviews?filter[rating]=1,2&filter[territory]=ESP&exists[publishedResponse]=false&sort=-createdDate&limit=200&include=response

• Filtros: filter[rating], filter[territory], exists[publishedResponse] (para encontrar reseñas sin respuesta).
• Orden: rating, -rating, createdDate, -createdDate. limit hasta 200.
• Atributos: rating, title, body, reviewerNickname, createdDate, territory.
• Por versión: GET /v1/appStoreVersions/{id}/customerReviews.

Fuentes: App Store Connect API: List all customer reviews for an app; App Store Connect API: Customer Reviews.

Responder

POST https://api.appstoreconnect.apple.com/v1/customerReviewResponses
Content-Type: application/json

{"data": {"type": "customerReviewResponses",
  "attributes": {"responseBody": "Gracias, Sara. La 4.2.1 corrige el error de sincronización."},
  "relationships": {"review": {"data": {"type": "customerReviews", "id": "REVIEW_ID"}}}}}

• Cada reseña tiene como máximo una respuesta. Si ya existe, esta solicitud la sobrescribe (App Store Connect API: Create or update a response to a customer review).
• Las respuestas no aparecen al instante. El state de la respuesta es PENDING_PUBLISH o PUBLISHED (App Store Connect API: Customer Review Responses).
• Léela con GET /v1/customerReviews/{id}/response; bórrala con DELETE /v1/customerReviewResponses/{id} (App Store Connect API: Customer Review Responses).

Las reglas siguen valiendo

Las respuestas por API siguen las mismas reglas que en App Store Connect: respeto y nada de información personal, spam ni marketing (directriz 5.6.1, App Store Review Guidelines (5.6.1, 5.6.3, 5.6.4)). Se avisa a quien escribió la reseña, que puede actualizarla (Apple Developer: Ratings, reviews, and responses).

Fuentes

• App Store Connect API: Generating tokens for API requests
• App Store Connect API: List all customer reviews for an app
• App Store Connect API: Customer Reviews
• App Store Connect API: Create or update a response to a customer review
• App Store Connect API: Customer Review Responses
• App Store Review Guidelines (5.6.1, 5.6.3, 5.6.4)
• Apple Developer: Ratings, reviews, and responses

Guías relacionadas

• Cómo responder a las reseñas de la App Store: las reglas de Apple
• API de Google Play para responder a reseñas: listar y responder
• Cómo analizar las reseñas de tu app para la hoja de ruta del producto
• Todas las guías para desarrolladores

Preguntas frecuentes

¿Cómo encuentro reseñas de la App Store sin respuesta con la API?

Lista las reseñas de clientes con exists[publishedResponse]=false.

¿Puede una reseña de la App Store tener más de una respuesta?

No. Cada reseña tiene como máximo una respuesta; si publicas otra, sobrescribe la anterior.

¿Cuántas reseñas puedo obtener por solicitud?

El parámetro limit admite hasta 200 en el endpoint de listado.

¿Por qué todavía no se ve mi respuesta?

Apple indica que las respuestas no aparecen al instante; el estado sigue en PENDING_PUBLISH hasta que se publica.