# Google Play Store API — app and game details (installs, exact install count, rating histogram, price, version, developer e-mail / address / phone, data safety, permissions), search, reviews with developer replies, similar apps, developer apps, top charts by category and country

> Everything the store page shows about one app or game: install range and the exact install count, rating, rating count, review count, 1-5 star histogram, rating per device type, price and currency, in-app purchase range, Contains ads, content rating, version, Updated and Released dates, required Android, the developer (name, id, website, support e-mail, legal name, address, phone), privacy policy, data-safety summary, permissions, categories and tags, chart rank, screenshots, video, What's new and the full description.
> ReefAPI engine `google-play` · 10 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/google-play/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed calls are free.
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http). Clients that add connectors by URL, such as ChatGPT and the Claude app, connect with OAuth 2.1 (the user pastes their key once on a ReefAPI page; discovery at `/.well-known/oauth-protected-resource/mcp`). Config files send the key as `Authorization: Bearer <key>`. `?key=<key>` in the URL also works as a last-resort fallback.

## Endpoints

### POST https://api.reefapi.com/google-play/v1/details — 1 credit
Everything the store page shows about one app or game: install range and the exact install count, rating, rating count, review count, 1-5 star histogram, rating per device type, price and currency, in-app purchase range, Contains ads, content rating, version, Updated and Released dates, required Android, the developer (name, id, website, support e-mail, legal name, address, phone), privacy policy, data-safety summary, permissions, categories and tags, chart rank, screenshots, video, What's new and the full description.

**Parameters:**
- `app_id` (string, required) — The app: its package name (com.whatsapp) or any play.google.com/store/apps/details?id=… link.
- `country` (string, optional, default "us") — Store country as a two-letter code (us, de, gb, jp, in, br, tr …). Decides the catalogue, charts and the price currency (Minecraft: USD 6.99 in us, EUR 6,99 in de, JPY 1,300 in jp — measured). Default us.
- `language` (string, optional, default "en") — Language of names, descriptions and dates (ISO code: en, de, ja, pt-BR …). For reviews it also picks which reviews are shown. Default en.

**Returns:** app_id, title, link, summary, description, description_html, recent_changes, developer{name, id, page_id, link, listed_by_name, website, email, address, phone, legal_name, legal_email, legal_address, legal_phone}, genre, genre_id, categories[], tags[], rating, rating_text, ratings_count, ratings_count_text, reviews_count, histogram{1..5}, ratings_by_device[]{device, device_code, rating}, installs, installs_short, min_installs, real_installs, price, price_micros, currency, price_text, is_free, original_price, price_note, offers_in_app_purchases, in_app_purchases, contains_ads, ads_label, content_rating, content_rating_icon_url, content_descriptors, interactive_elements, released, released_at, updated, updated_at, version, android_min_version, android_min_sdk, android_target_sdk, android_max_version, android_max_sdk, chart_rank{chart, rank}, preregistration, early_access, early_access_note, play_pass, family_library_eligible, family_library_note, privacy_policy_url, data_safety_summary[], data_safety_link, permissions[]{group, permissions[]}, icon_url, header_image_url, screenshots[], video_url, video_youtube_id, video_thumbnail_url, preview_video_url, sale_ends_at (during a sale)

**Example request body:**
```json
{
  "app_id": "com.whatsapp"
}
```

### POST https://api.reefapi.com/google-play/v1/search — 2 credits
Search the Play Store like its search box (apps and games), optionally only free or only paid apps. Real paging with next_cursor: the store serves about 240-250 results per query (measured: 238 for 'photo editor'). When the store rewrites a query it cannot match, searched_for shows what it searched instead.

**Parameters:**
- `query` (string, required) — Search words, as typed in the store's search box.
- `price` (enum, optional, default "all") — Only free or only paid apps — the store's own price filter (default all). The store lets a few rows of the other kind through (measured: 1 free app in 30 'paid' rows); this API removes them (meta.extra.rows_other_price_removed), so a page can hold fewer rows than page_size. [one of: all, free, paid]
- `page_size` (integer, optional, default 20) — Results per page, 1-50 (default 20).
- `cursor` (string, optional) — next_cursor from the previous page of the same list (leave empty for the first page).
- `country` (string, optional, default "us") — Store country as a two-letter code (us, de, gb, jp, in, br, tr …). Decides the catalogue, charts and the price currency (Minecraft: USD 6.99 in us, EUR 6,99 in de, JPY 1,300 in jp — measured). Default us.
- `language` (string, optional, default "en") — Language of names, descriptions and dates (ISO code: en, de, ja, pt-BR …). For reviews it also picks which reviews are shown. Default en.

**Returns:** query, searched_for, price, count, next_cursor, items[]{rank, app_id, title, link, developer, category, rating, rating_text, installs, price, price_micros, currency, price_text, is_free, in_app_purchases, content_rating, content_descriptors, interactive_elements, description, icon_url, header_image_url, screenshots[]}

**Example request body:**
```json
{
  "query": "photo editor"
}
```

### POST https://api.reefapi.com/google-play/v1/reviews — 1 credit
An app's user reviews with star rating, text, reviewer name and id, date, helpful votes, app version, the store's aspect ratings and the developer's reply. Sort newest / most relevant / by rating; filter by stars, positive (4-5) or critical (1-3), and by device (phone, tablet, watch, chromebook, tv, car). Real paging.

**Parameters:**
- `app_id` (string, required) — The app: its package name (com.whatsapp) or any play.google.com/store/apps/details?id=… link.
- `sort` (enum, optional, default "newest") — Order (default newest). [one of: newest, most_relevant, rating]
- `rating` (integer, optional) — Only reviews with this many stars (1-5).
- `sentiment` (enum, optional) — Only positive (4-5 stars) or only critical (1-3 stars) reviews. Not together with rating. [one of: positive, critical]
- `device` (enum, optional) — Only reviews written on this kind of device (default: the store's own default, all devices). [one of: phone, tablet, watch, chromebook, tv, car]
- `page_size` (integer, optional, default 50) — Reviews per page, 1-200 (default 50).
- `cursor` (string, optional) — next_cursor from the previous page of the same list (leave empty for the first page).
- `country` (string, optional, default "us") — Store country as a two-letter code (us, de, gb, jp, in, br, tr …). Decides the catalogue, charts and the price currency (Minecraft: USD 6.99 in us, EUR 6,99 in de, JPY 1,300 in jp — measured). Default us.
- `language` (string, optional, default "en") — Language of names, descriptions and dates (ISO code: en, de, ja, pt-BR …). For reviews it also picks which reviews are shown. Default en.

**Returns:** app_id, sort, rating, sentiment, device, count, next_cursor, reviews[]{review_id, link, rating, title, text, author{name, id, avatar_url}, created_at, helpful_count, app_version, criteria[]{criterion, rating}, developer_reply{author, text, replied_at}}

**Example request body:**
```json
{
  "app_id": "com.whatsapp"
}
```

### POST https://api.reefapi.com/google-play/v1/similar — 1 credit
The store's Similar apps list for an app (the full list behind the detail page's Similar apps shelf), with real paging.

**Parameters:**
- `app_id` (string, required) — The app: its package name (com.whatsapp) or any play.google.com/store/apps/details?id=… link.
- `page_size` (integer, optional, default 20) — Apps per page, 1-50 (default 20).
- `cursor` (string, optional) — next_cursor from the previous page of the same list (leave empty for the first page).
- `country` (string, optional, default "us") — Store country as a two-letter code (us, de, gb, jp, in, br, tr …). Decides the catalogue, charts and the price currency (Minecraft: USD 6.99 in us, EUR 6,99 in de, JPY 1,300 in jp — measured). Default us.
- `language` (string, optional, default "en") — Language of names, descriptions and dates (ISO code: en, de, ja, pt-BR …). For reviews it also picks which reviews are shown. Default en.

**Returns:** app_id, cluster, count, next_cursor, items[]{rank, app_id, title, link, developer, category, rating, rating_text, installs, price, price_micros, currency, price_text, is_free, in_app_purchases, content_rating, content_descriptors, interactive_elements, description, icon_url, header_image_url, screenshots[]}

**Example request body:**
```json
{
  "app_id": "com.whatsapp"
}
```

### POST https://api.reefapi.com/google-play/v1/developer — 1 credit
Every app a developer publishes, with real paging. Give the numeric developer id (it also returns the developer page header: name, description, icon, cover) or the developer name exactly as the store prints it (developer.page_id / developer.name in details).

**Parameters:**
- `developer` (string, required) — Numeric developer id (5700313618786177705), the developer name (WhatsApp LLC) or a play.google.com/store/apps/dev?id=… / developer?id=… link.
- `page_size` (integer, optional, default 20) — Apps per page, 1-50 (default 20).
- `cursor` (string, optional) — next_cursor from the previous page of the same list (leave empty for the first page).
- `country` (string, optional, default "us") — Store country as a two-letter code (us, de, gb, jp, in, br, tr …). Decides the catalogue, charts and the price currency (Minecraft: USD 6.99 in us, EUR 6,99 in de, JPY 1,300 in jp — measured). Default us.
- `language` (string, optional, default "en") — Language of names, descriptions and dates (ISO code: en, de, ja, pt-BR …). For reviews it also picks which reviews are shown. Default en.

**Returns:** developer{id, name, description, icon_url, cover_image_url, link, lookup}, total_hint, count, next_cursor, items[]{rank, app_id, title, link, developer, category, rating, rating_text, installs, price, price_micros, currency, price_text, is_free, in_app_purchases, content_rating, content_descriptors, interactive_elements, description, icon_url, header_image_url, screenshots[]}

**Example request body:**
```json
{
  "developer": "5700313618786177705"
}
```

### POST https://api.reefapi.com/google-play/v1/top_charts — 2 credits
The store's top charts: Top free, Top paid or Top grossing, for any category (all apps, all games, a game genre or an app category) and any country, ranked, up to 200 places (the chart's length).

**Parameters:**
- `chart` (enum, optional, default "top_free") — Which chart (default top_free). [one of: top_free, top_paid, top_grossing]
- `category` (string, optional, default "APPLICATION") — Category id: APPLICATION (all apps, default), GAME (all games), GAME_PUZZLE, COMMUNICATION, PRODUCTIVITY … or its label ('Puzzle', 'Health & Fitness'). Action `categories` lists them.
- `page_size` (integer, optional, default 50) — Places per page, 1-200 (default 50).
- `country` (string, optional, default "us") — Store country as a two-letter code (us, de, gb, jp, in, br, tr …). Decides the catalogue, charts and the price currency (Minecraft: USD 6.99 in us, EUR 6,99 in de, JPY 1,300 in jp — measured). Default us.
- `language` (string, optional, default "en") — Language of names, descriptions and dates (ISO code: en, de, ja, pt-BR …). For reviews it also picks which reviews are shown. Default en.

**Returns:** chart, category, country, count, items[]{rank, app_id, title, link, developer, category, rating, rating_text, installs, price, price_micros, currency, price_text, is_free, in_app_purchases, content_rating, content_descriptors, interactive_elements, description, icon_url, header_image_url, screenshots[]}

**Example request body:**
```json
{
  "chart": "top_free",
  "category": "GAME"
}
```

### POST https://api.reefapi.com/google-play/v1/categories — 0 credits
The store's category ids and labels (apps, games, kids) accepted by top_charts. No live request.

**Parameters:**
- `type` (enum, optional) — Only app, game or kids categories (default all). [one of: apps, games, kids]

**Returns:** count, categories[]{id, name, type, link}

### POST https://api.reefapi.com/google-play/v1/data_safety — 1 credit
The app's full Data safety declaration as the store shows it: data shared and data collected, per category and per data type with optional / required and the purposes, and the security practices (encryption in transit, deletion requests, Families policy …).

**Parameters:**
- `app_id` (string, required) — The app: its package name (com.whatsapp) or any play.google.com/store/apps/details?id=… link.
- `language` (string, optional, default "en") — Language of names, descriptions and dates (ISO code: en, de, ja, pt-BR …). For reviews it also picks which reviews are shown. Default en.

**Returns:** app_id, title, link, developer{…}, privacy_policy_url, declared, data_shared{title, none_text, categories[]{category, summary, data_types[]{data_type, optional, purposes}}}, data_collected{…}, security_practices[]{practice, description}

**Example request body:**
```json
{
  "app_id": "com.whatsapp"
}
```

### POST https://api.reefapi.com/google-play/v1/permissions — 1 credit
The Android permissions the app asks for, grouped as the store groups them (Location, Camera, Other …).

**Parameters:**
- `app_id` (string, required) — The app: its package name (com.whatsapp) or any play.google.com/store/apps/details?id=… link.
- `language` (string, optional, default "en") — Language of names, descriptions and dates (ISO code: en, de, ja, pt-BR …). For reviews it also picks which reviews are shown. Default en.

**Returns:** app_id, count, groups[]{group, permissions[]}

**Example request body:**
```json
{
  "app_id": "com.whatsapp"
}
```

### POST https://api.reefapi.com/google-play/v1/suggest — 1 credit
The search box's autocomplete suggestions for a partial query.

**Parameters:**
- `query` (string, required) — The partial search text.
- `country` (string, optional, default "us") — Store country as a two-letter code (us, de, gb, jp, in, br, tr …). Decides the catalogue, charts and the price currency (Minecraft: USD 6.99 in us, EUR 6,99 in de, JPY 1,300 in jp — measured). Default us.
- `language` (string, optional, default "en") — Language of names, descriptions and dates (ISO code: en, de, ja, pt-BR …). For reviews it also picks which reviews are shown. Default en.

**Returns:** query, count, suggestions[]{term, search_link}

**Example request body:**
```json
{
  "query": "photo ed"
}
```

## At scale
- **Volume:** 5M+ requests a day, measured at 60 requests a second across the fleet with no
  central bottleneck. Per-key limits are raised for high-volume accounts; volume pricing on request.
- **Missing a source:** tell us a site we do not cover and it becomes an engine. A customer asked
  for bestprice.gr on 21 Sep 2026 and it was in the catalog on 22 Sep.
- **Support:** 2 minute median time from a question in the live chat to the first answer. Setup
  help included, no support tier to buy.
- **One key, one credit pool** across every API. No per-site plans, no separate subscriptions.

## More
- Try it live, no code: https://reefapi.com/playground?engine=google-play
- Human docs page: https://reefapi.com/docs/google-play
- Overview page: https://reefapi.com/google-play-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt
