app-reviews 0.2.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 client.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

No authentication (public endpoints)

from app_reviews import AppStoreReviews, Country

client = AppStoreReviews()
result = client.fetch("324684580", countries=[Country.US, Country.GB])

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

from app_reviews import GooglePlayReviews, Country

client = GooglePlayReviews()
result = client.fetch("com.instagram.android", countries=[Country.US])

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

With authentication (official APIs)

from app_reviews import AppStoreReviews, AppStoreAuth, Country

auth = AppStoreAuth(
    key_id="ABC123DEF4",
    issuer_id="12345678-1234-1234-1234-123456789012",
    key_path="/path/to/AuthKey.p8",
)

client = AppStoreReviews(auth=auth)
spotify = client.fetch("324684580", countries=[Country.US, Country.GB])
instagram = client.fetch("389801252", countries=[Country.US])

from app_reviews import GooglePlayReviews, GooglePlayAuth, Country

auth = GooglePlayAuth(service_account_path="/path/to/service-account.json")

client = GooglePlayReviews(auth=auth)
result = client.fetch("com.instagram.android", countries=[Country.US])

Retry and proxy

from app_reviews import AppStoreReviews, RetryConfig

retry = RetryConfig(
    max_retries=5,       # default: 3
    backoff_factor=1.0,  # wait 1s, 2s, 4s, ... between retries (default: 0.5)
    timeout=60.0,        # per-request timeout in seconds (default: 30.0)
    retry_on=[429, 503], # HTTP status codes to retry on (default: [429, 503])
)

client = AppStoreReviews(retry=retry, proxy="http://proxy.example.com:8080")
result = client.fetch("324684580", countries=["us"])

Export results

from app_reviews import GooglePlayReviews
from app_reviews.exporters.json import export_json
from app_reviews.exporters.csv import export_csv
from app_reviews.exporters.jsonl import export_jsonl

client = GooglePlayReviews()
result = client.fetch("com.instagram.android")

export_json(result.reviews)   # JSON array string
export_csv(result.reviews)    # CSV string with headers
export_jsonl(result.reviews)  # one JSON object per line

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.

Community

• Code of Conduct -- our standards for participation
• Security Policy -- how to report vulnerabilities
• Contributing -- how to submit changes

License

MIT