App Store Reviews Scraper

This actor scrapes user reviews from the Apple App Store for any iOS application. It extracts live data, including review text, ratings, and user details, and operates on a pay-per-result model.

Key Features

• Comprehensive Data: Scrapes review titles, full text, star ratings (1-5), timestamps, and the app version at the time of review.
• User Details: Captures reviewer usernames and profile URLs.
• Multi-Region Support: Works with major App Store countries (US, GB, AU, CA, DE, FR, JP, CN).
• Flexible Limits: Configure the number of reviews to scrape, up to 10,000.
• Pay-per-Result: You are only charged for successfully scraped reviews.

How to Use

1. Configure Input: Provide the app identifier and target country.
2. Set a Limit (Optional): Define the maximum number of reviews to retrieve. Defaults to 100.
3. Run the Actor: Execute it with your input configuration.
4. Get Results: Output is delivered as individual JSON items in your dataset.

Input

Provide input as a JSON object. You must supply either id or appId.

Required:
* id or appId: The unique identifier for the app on the App Store.
* country: The two-letter country code for the App Store region (e.g., us, gb, au).

Optional:
* limit: The maximum number of reviews to scrape (default: 100, max: 10000).

Example Input:

{
  "appId": "com.facebook.Facebook",
  "country": "us",
  "limit": 250
}

Output

The actor outputs each review as a separate JSON object with the following structure:

{
  "id": "11709937316",
  "userName": "reviewer_username",
  "userUrl": "https://itunes.apple.com/us/reviews/id904957940",
  "version": "1.285.0.1",
  "score": 1,
  "title": "Review Title",
  "text": "Full text of the user review...",
  "url": "https://itunes.apple.com/us/review?id=553834731&type=Purple%20Software",
  "updated": "2024-09-10T10:05:32-07:00"
}

Data Fields:
* id: Unique review identifier.
* userName, userUrl: Reviewer's display name and profile link.
* version: App version when the review was written.
* score: Star rating (1-5).
* title, text: The review's title and body.
* url: Direct link to the review.
* updated: Timestamp of the review's last update (ISO 8601 format).

Common Use Cases

• App Analysis: Perform sentiment analysis, track bug reports, or identify feature requests from user feedback.
• Market Research: Understand user preferences, compare regional differences, or monitor how app updates affect review scores over time.
• Competitive Analysis: Compare user feedback across different applications in the same category.