Google Play Store API: any app's rating and installs

export TOOLZERHUB_API_KEY=your_key
curl -H "x-api-key: $TOOLZERHUB_API_KEY" \
  "https://api.toolzerhub.com/v1/google-play/app?package_id_or_url=https://play.google.com/store/apps/details?id=com.duolingo"

{
  "package_id": "com.duolingo",
  "title": "Duolingo: Learn Languages",
  "developer": {"name": "Duolingo", "id": "6957685454452609502"},
  "rating": 4.7441278,
  "ratings_count": 48837193,
  "installs": "500,000,000+",
  "content_rating": "Everyone",
  "released": "May 29, 2013",
  "updated": "Nov 3, 2026",
  "contains_ads": true,
  "in_app_purchases": "$0.99 - $239.99 per item"
}

import csv
import os
import statistics
import sys
import time
from datetime import date, datetime

import requests

API = "https://api.toolzerhub.com/v1/google-play"
HEADERS = {"x-api-key": os.environ.get("TOOLZERHUB_API_KEY", "")}
FIELDS = ["query", "rank", "package_id", "title", "developer", "rating", "ratings_count", "installs",
          "released", "updated", "days_since_update", "contains_ads", "in_app_purchases", "url"]


def get(op, params, tries=3):
    # Retry rate limits, server errors and dropped connections.
    for attempt in range(tries):
        last = attempt == tries - 1
        try:
            r = requests.get(f"{API}/{op}", headers=HEADERS, params=params, timeout=120)
        except requests.RequestException:
            if last:
                raise
            time.sleep(5 * (attempt + 1))
            continue
        if r.status_code in (429, 500, 502, 503, 504) and not last:
            time.sleep(5 * (attempt + 1))
            continue
        r.raise_for_status()
        return r.json()["data"]


def days_since(text):
    # The store shows dates such as "Nov 2, 2026".
    try:
        return (date.today() - datetime.strptime(text, "%b %d, %Y").date()).days
    except (TypeError, ValueError):
        return None


def main(queries, top="10", out="google_play_apps.csv"):
    with open(out, "w", newline="", encoding="utf-8") as f:
        writer = csv.DictWriter(f, fieldnames=FIELDS)
        writer.writeheader()
        for query in filter(None, (q.strip() for q in queries.split(","))):
            results = get("search", {"q": query})["results"][: int(top)]
            apps, failed = [], 0
            for rank, r in enumerate(results, 1):
                try:
                    a = get("app", {"package_id_or_url": r["package_id"]})
                except requests.HTTPError as e:
                    # Skip an app whose page fails; stop on key or credit errors.
                    if e.response.status_code < 500:
                        raise
                    failed += 1
                    continue
                apps.append(a)
                writer.writerow({
                    "query": query, "rank": rank, "package_id": a["package_id"], "title": a["title"],
                    "developer": (a.get("developer") or {}).get("name"), "rating": a.get("rating"),
                    "ratings_count": a.get("ratings_count"), "installs": a.get("installs"),
                    "released": a.get("released"), "updated": a.get("updated"),
                    "days_since_update": days_since(a.get("updated")), "contains_ads": a.get("contains_ads"),
                    "in_app_purchases": a.get("in_app_purchases"),
                    "url": f"https://play.google.com/store/apps/details?id={a['package_id']}",
                })
            ratings = [a["rating"] for a in apps if a.get("rating")]
            stale = sum((days_since(a.get("updated")) or 0) > 180 for a in apps)
            print(f"{query}: top {len(apps)} apps, median rating {statistics.median(ratings or [0]):.2f}, "
                  f"{sum(bool(a.get('contains_ads')) for a in apps)} with ads, "
                  f"{sum(bool(a.get('in_app_purchases')) for a in apps)} with in-app purchases, "
                  f"{stale} not updated in 180 days" + (f"; {failed} skipped" if failed else ""))


if __name__ == "__main__":
    if len(sys.argv) < 2:
        sys.exit('usage: python google_play_apps.py "habit tracker,expense tracker" [top] [out.csv]')
    if not HEADERS["x-api-key"]:
        sys.exit("set TOOLZERHUB_API_KEY first")
    main(*sys.argv[1:])