app-reviews 0.1.0

The go-to Python package for App Store and Google Play review extraction

App Reviews

Fetch app reviews from the Apple App Store and Google Play Store with a single Python package.

Why App Reviews?

Fetching app reviews should be simple. In practice, it is not:

• Apple and Google use completely different APIs, formats, and auth methods
• Getting reviews from multiple countries means handling deduplication
• Google rate-limits aggressively, Apple requires JWT signing
• Most existing tools only support one store

App Reviews handles all of this behind a single scraper.fetch() call. It works out of the box with no API keys, and optionally supports authenticated APIs for more data.

Install

pip install app-reviews

Quick Start

from app_reviews import AppStoreScraper, GooglePlayScraper

# Apple App Store
apple = AppStoreScraper(app_id="123456789", countries=["us", "gb"])
result = apple.fetch()

for review in result.reviews:
    print(f"[{review.country}] {review.rating}★ {review.title}")

# Google Play Store
google = GooglePlayScraper(app_id="com.example.app", countries=["us", "gb"])
result = google.fetch()

for review in result.reviews:
    print(f"[{review.country}] {review.rating}★ {review.body[:80]}")

Features

• Both stores -- Apple App Store and Google Play in one package
• No API keys required -- works out of the box using public endpoints
• 175+ countries -- fetch and deduplicate across regions in a single call
• Official API support -- optionally use App Store Connect or Google Play Developer API
• Python API, CLI, and interactive TUI -- use it however you prefer
• 4 export formats -- table, JSON, JSONL, CSV
• Minimal dependencies -- just cryptography for JWT signing, stdlib urllib for HTTP

Documentation

Read the full documentation

• Installation -- all install methods
• Quick Start -- first reviews in 2 minutes
• Python API -- full reference with all parameters
• CLI -- command-line usage
• Interactive TUI -- browse reviews in your terminal
• Authentication -- set up official APIs
• How It Works -- providers, limitations, internals

Contributing

git clone https://github.com/firattamurcw/app-reviews.git
cd app-reviews
uv sync --group dev
make test

See the Contributing Guide for details.

License

MIT