Skip to main content
GET /v1/apps/:id/reviews
Fetches user reviews from Apple’s public RSS feed. Returns up to 50 reviews per page, with a maximum of 10 pages (500 reviews total per country).

​
Path Parameters

NameTypeRequiredDescription
idstringYesApple App ID (numeric, e.g. 1617391485)

​
Query Parameters

NameTypeDefaultDescription
countrystringusISO country code (e.g. us, gb, jp)
pagenumber1Page number (1–10)
sortBystringmostRecentSort order: mostRecent or mostHelpful

​
Code Examples

curl -X GET "https://api.appeeky.com/v1/apps/1617391485/reviews?country=us&page=1&sortBy=mostRecent" \
  -H "X-API-Key: YOUR_API_KEY"

​
Response

{
  "data": {
    "appId": "1617391485",
    "reviews": [
      {
        "author": "PuzzleFan92",
        "rating": 5,
        "title": "Best puzzle game ever!",
        "content": "I've been playing this for months. The levels are challenging but fair, and the design is beautiful. Highly recommended for anyone who loves block puzzles.",
        "date": "2026-02-10T12:00:00Z"
      },
      {
        "author": "CasualGamer_Jake",
        "rating": 4,
        "title": "Fun but too many ads",
        "content": "Great gameplay and very addictive, but the ads between levels are a bit much. Would happily pay to remove them if that was an option.",
        "date": "2026-02-09T08:30:00Z"
      },
      {
        "author": "iPhoneUser2024",
        "rating": 2,
        "title": "Crashes after latest update",
        "content": "The app keeps crashing after the latest update on my iPhone 14. Was working perfectly before. Please fix this ASAP.",
        "date": "2026-02-08T15:45:00Z"
      }
    ],
    "hasMore": true,
    "page": 1
  }
}

​
Review Object

FieldTypeDescription
authorstringReviewer display name
ratingnumberStar rating (1–5)
titlestringReview title / headline
contentstringReview body text (only reviews with written content)
datestringReview date (ISO 8601)

​
Pagination

FieldTypeDescription
hasMorebooleantrue if more pages are available
pagenumberCurrent page number
Apple’s RSS feed provides a maximum of 10 pages with up to 50 reviews per page, giving a ceiling of 500 reviews per country.
Sort options:
  • mostRecent — Returns the newest reviews first. Best for monitoring recent user sentiment and catching new issues.
  • mostHelpful — Returns reviews that other users found most helpful. Best for understanding the most impactful feedback.
Reviews without written content are automatically filtered out. The first entry in Apple’s RSS feed (app summary) is also excluded.
Filtering strategies: To analyze reviews effectively, consider:
  • Paginate through all 10 pages to get a comprehensive view (up to 500 reviews)
  • Use mostRecent to track sentiment after an app update
  • Use mostHelpful to surface the most impactful user feedback
  • Combine with different country codes to compare regional sentiment
  • Filter by rating on the client side to focus on negative reviews (1–2 stars) or positive ones (4–5 stars)

​
Errors

StatusCodeWhen
400INVALID_APP_IDNon-numeric or missing app ID
400INVALID_PAGEPage number outside 1–10 range
401MISSING_API_KEYNo API key in the request
401INVALID_API_KEYInvalid or expired API key