App Store Connect API: read and respond to customer reviews

Español · Deutsch · Polski · Français

The App Store Connect API exposes your customer reviews and lets you create, update and delete responses. Endpoints and parameters below are from Apple's API reference.

Free app review check · Review export · Reply generator · Sample report · Report €19 · Competitor Pack €29 · Monitor €29/month

Authentication

Requests use a JSON Web Token signed with an App Store Connect API key (App Store Connect API: Generating tokens for API requests).

List reviews

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

Filters: filter[rating], filter[territory], exists[publishedResponse] (find unanswered reviews).
Sort: rating, -rating, createdDate, -createdDate. limit up to 200.
Attributes: rating, title, body, reviewerNickname, createdDate, territory.
Per version: GET /v1/appStoreVersions/{id}/customerReviews.

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

Respond

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"}}}}}

A review has at most one response. If one exists, this request overwrites it (App Store Connect API: Create or update a response to a customer review).
Responses don't appear instantly. The response's state is PENDING_PUBLISH or PUBLISHED (App Store Connect API: Customer Review Responses).
Read it with GET /v1/customerReviews/{id}/response; delete it with DELETE /v1/customerReviewResponses/{id} (App Store Connect API: Customer Review Responses).

Rules still apply

Responses via the API follow the same rules as App Store Connect: respectful, no personal information, spam or marketing (guideline 5.6.1, App Store Review Guidelines (5.6.1, 5.6.3, 5.6.4)). The reviewer is notified and can update their review (Apple Developer: Ratings, reviews, and responses).

Sources

Related guides

Questions

How do I find unanswered App Store reviews with the API?

List customer reviews with exists[publishedResponse]=false.

Can an App Store review have more than one response?

No. A review has at most one response; posting again overwrites it.

How many reviews can I fetch per request?

The limit parameter accepts up to 200 for the list endpoint.

Why doesn't my response show yet?

Apple says responses don't appear instantly; the state stays PENDING_PUBLISH until it is published.