API App Store Connect: odczytywanie opinii klientów i odpowiadanie na nie

English · Español · Deutsch · Français

API App Store Connect udostępnia opinie klientów i pozwala tworzyć, aktualizować i usuwać odpowiedzi. Poniższe endpointy i parametry pochodzą z dokumentacji API Apple.

Darmowa analiza opinii o Twojej aplikacji · Opinie o popularnych aplikacjach · Raport 19 € (cena na start, 49 € od 1 grudnia 2026) · Competitor Pack 29 € · Eksport opinii · Generator odpowiedzi · Przykładowy raport · Monitor opinii 29 €/mies.

Uwierzytelnianie

Żądania korzystają z tokena sieciowego JSON (JWT) podpisanego kluczem API App Store Connect (App Store Connect API: Generating tokens for API requests).

Pobieranie listy opinii

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

Filtry: filter[rating], filter[territory], exists[publishedResponse] (znajduje opinie bez odpowiedzi).
Sortowanie: rating, -rating, createdDate, -createdDate. limit do 200.
Atrybuty: rating, title, body, reviewerNickname, createdDate, territory.
Według wersji: GET /v1/appStoreVersions/{id}/customerReviews.

Źródła: App Store Connect API: List all customer reviews for an app; App Store Connect API: Customer Reviews.

Odpowiadanie

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

{"data": {"type": "customerReviewResponses",
  "attributes": {"responseBody": "Thanks, Sam. 4.2.1 fixes the sync bug."},
  "relationships": {"review": {"data": {"type": "customerReviews", "id": "REVIEW_ID"}}}}}

Opinia ma co najwyżej jedną odpowiedź. Jeśli już istnieje, to żądanie ją nadpisuje (App Store Connect API: Create or update a response to a customer review).
Odpowiedzi nie pojawiają się natychmiast. Pole state odpowiedzi ma wartość PENDING_PUBLISH lub PUBLISHED (App Store Connect API: Customer Review Responses).
Odczytasz ją przez GET /v1/customerReviews/{id}/response, a usuniesz przez DELETE /v1/customerReviewResponses/{id} (App Store Connect API: Customer Review Responses).

Zasady nadal obowiązują

Odpowiedzi przez API podlegają tym samym zasadom co w App Store Connect: muszą być pełne szacunku, nie mogą zawierać danych osobowych, spamu ani treści marketingowych (wytyczna 5.6.1, App Store Review Guidelines (5.6.1, 5.6.3, 5.6.4)). Autor opinii jest powiadamiany i może ją zaktualizować (Apple Developer: Ratings, reviews, and responses).

Źródła

Powiązane poradniki

Najczęstsze pytania

Jak znaleźć opinie z App Store bez odpowiedzi za pomocą API?

Pobierz listę opinii klientów z filtrem exists[publishedResponse]=false.

Czy opinia z App Store może mieć więcej niż jedną odpowiedź?

Nie. Każda opinia ma co najwyżej jedną odpowiedź; ponowna publikacja ją nadpisuje.

Ile opinii mogę pobrać w jednym żądaniu?

Parametr limit akceptuje do 200 w endpoincie listy opinii.

Dlaczego moja odpowiedź jeszcze się nie pojawia?

Apple podaje, że odpowiedzi nie pojawiają się natychmiast; stan pozostaje PENDING_PUBLISH, dopóki nie zostanie opublikowana.