App Store Connect API: Kundenbewertungen lesen und beantworten

English · Español · Polski · Français

Die App Store Connect API stellt die Kundenrezensionen deiner Apps bereit und lässt dich Antworten veröffentlichen, ersetzen und löschen. So funktioniert es laut Apples Dokumentation.

Kostenlose Prüfung der Bewertungen deiner App · Bewertungen beliebter Apps · Report 19 € (Einführungspreis, 49 € ab 1. Dez. 2026) · Competitor Pack 29 € · Review-Export · Antwort-Generator · Beispiel-Report · Monitor 29 €/Monat

Authentifizierung

Anfragen nutzen ein JSON Web Token, das mit einem App-Store-Connect-API-Schlüssel signiert ist (App Store Connect API: Generating tokens for API requests).

Rezensionen abrufen

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

Filter: filter[rating], filter[territory], exists[publishedResponse] (findet unbeantwortete Rezensionen).
Sortierung: rating, -rating, createdDate, -createdDate. limit bis 200.
Attribute: rating, title, body, reviewerNickname, createdDate, territory.
Pro Version: GET /v1/appStoreVersions/{id}/customerReviews.

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

Antworten

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

{"data": {"type": "customerReviewResponses",
  "attributes": {"responseBody": "Danke, Sara. Version 4.2.1 behebt den Sync-Fehler."},
  "relationships": {"review": {"data": {"type": "customerReviews", "id": "REVIEW_ID"}}}}}

Eine Rezension hat höchstens eine Antwort. Gibt es schon eine, überschreibt diese Anfrage sie (App Store Connect API: Create or update a response to a customer review).
Antworten erscheinen nicht sofort. Der state der Antwort ist PENDING_PUBLISH oder PUBLISHED (App Store Connect API: Customer Review Responses).
Lesen mit GET /v1/customerReviews/{id}/response, löschen mit DELETE /v1/customerReviewResponses/{id} (App Store Connect API: Customer Review Responses).

Die Regeln gelten weiter

Antworten über die API folgen denselben Regeln wie in App Store Connect: respektvoll, ohne persönliche Daten, Spam oder Marketing (Richtlinie 5.6.1, App Store Review Guidelines (5.6.1, 5.6.3, 5.6.4)). Die Person, die die Rezension geschrieben hat, wird benachrichtigt und kann sie aktualisieren (Apple Developer: Ratings, reviews, and responses).

Quellen

Häufige Fragen

Wie finde ich mit der API unbeantwortete App-Store-Rezensionen?

Ruf die Kundenrezensionen mit exists[publishedResponse]=false ab.

Kann eine App-Store-Rezension mehr als eine Antwort haben?

Nein. Eine Rezension hat höchstens eine Antwort; eine neue überschreibt die alte.

Wie viele Rezensionen bekomme ich pro Anfrage?

Der Parameter limit akzeptiert beim Listen-Endpunkt bis zu 200.

Warum ist meine Antwort noch nicht zu sehen?

Laut Apple erscheinen Antworten nicht sofort; der Status bleibt PENDING_PUBLISH, bis sie veröffentlicht ist.