Skip to main content
Use these endpoints to list customer reviews for your app and create or update your responses. Only works for apps you own in App Store Connect.
One response per request: Each response requires a separate POST call. There is no batch endpoint — to respond to multiple reviews, call the endpoint once per review.

​
List Customer Reviews

GET /v1/connect/apps/:appId/customer-reviews
List customer reviews with pagination. Returns rating, title, body, reviewer nickname, date, territory, and whether you’ve responded.

​
Path Parameters

NameTypeDescription
appIdstringApp Store Connect app ID (from List apps)

​
Query Parameters

NameTypeDefaultDescription
limitnumber50Max results per page (1–200)
cursorstring—Cursor for next page (from links.next in previous response)

​
Response

{
  "data": [
    {
      "type": "customerReviews",
      "id": "abc123-review-id",
      "attributes": {
        "rating": 5,
        "title": "Great app!",
        "body": "Love the tape recorder style...",
        "reviewerNickname": "User123",
        "createdDate": "2024-03-15T10:30:00Z",
        "territory": "USA"
      },
      "relationships": {
        "response": {
          "data": null
        }
      }
    }
  ],
  "links": {
    "next": "https://..."
  }
}
AttributeDescription
rating1–5 stars
titleReview title
bodyFull review text
reviewerNicknameAnonymous nickname
createdDateWhen the review was submitted
territoryCountry/region code

​
Respond to Review

POST /v1/connect/customer-reviews/response
Create or update your response to one customer review. Each request targets a single reviewId. If you already responded to that review, this replaces the existing response. To respond to multiple reviews, call this endpoint once per review.

​
Request Body

{
  "reviewId": "abc123-review-id",
  "responseBody": "Thank you for your feedback! We're glad you enjoy the app."
}
FieldTypeRequiredDescription
reviewIdstringYesCustomer review ID from list response
responseBodystringYesYour reply text (non-empty)

​
Response

{
  "data": {
    "type": "customerReviewResponses",
    "id": "response-id",
    "attributes": {
      "responseBody": "Thank you for your feedback!",
      "lastModifiedDate": "2024-03-16T14:00:00Z"
    },
    "relationships": {
      "review": {
        "data": {
          "type": "customerReviews",
          "id": "abc123-review-id"
        }
      }
    }
  }
}

​
MCP Tools

Reviews endpoints are also available as MCP tools. Provide your App Store Connect credentials when calling:
ToolDescription
asc_list_customer_reviewsList customer reviews for your app (limit, cursor)
asc_respond_to_reviewRespond to a single review by ID
Example prompt for an AI assistant: 
List my app's customer reviews (app ID 6759740679) and respond to any 1–2 star reviews 
with a helpful support message.

​
Code Example

# List reviews
curl -X GET "https://api.appeeky.com/v1/connect/apps/6759740679/customer-reviews?limit=20" \
  -H "X-API-Key: YOUR_APEEKY_KEY" \
  -H "X-ASC-Issuer-Id: YOUR_ISSUER_ID" \
  -H "X-ASC-Key-Id: YOUR_KEY_ID" \
  -H "X-ASC-Private-Key: YOUR_PRIVATE_KEY"

# Respond to a review
curl -X POST "https://api.appeeky.com/v1/connect/customer-reviews/response" \
  -H "X-API-Key: YOUR_APEEKY_KEY" \
  -H "X-ASC-Issuer-Id: YOUR_ISSUER_ID" \
  -H "X-ASC-Key-Id: YOUR_KEY_ID" \
  -H "X-ASC-Private-Key: YOUR_PRIVATE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"reviewId":"abc123-review-id","responseBody":"Thank you for your feedback!"}'