Google Play Store API

Google Play apps, reviews and charts as JSON

endpoints
10
credits per call
0–2

This API reads play.google.com logged out and returns what the store publishes as plain JSON.

POST/google-play/v1/search
Real result, captured Nov 16, 20263 of 20
titlepricerankdeveloper
Photo Editor - Polish0 USD1InShot Inc.
Picsart AI Photo Editor, Video0 USD2PicsArt, Inc.
Photoshop Express Photo Editor0 USD3Adobe
10 active endpoints, on 0, 1 and 2 credit tiers.details · search · reviews · similar · developer · top_charts+4 more ↓OpenAPI 3.0 spec ↗

2 credits per call≈ $2/1,000 calls1,000 free credits, no card

Get a free API key
Try it live

Run the call yourself, on the real endpoint

Change a parameter and press Try it. The response on the right is what your code will receive.

Google Play Store API

5 of 10 endpoints, ready to run

View docs ↗

Full listing with exact installs and developer

1 credit1 required · 1 optional
POST/google-play/v1/details
idle
// Press "Try it" and this pane shows exactly what the
// live site returned this second — including an empty
// result, if that is the truth. No key, no account.

Try every endpoint in the playground

Endpoints

What Google Play Store endpoints does ReefAPI ship?

10 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.

  • details

    1 cr

    Everything the store page shows about one app or game.

    required
    —
    optional
    —
  • search

    2 cr

    Search the Play Store like its search box (apps and games), optionally only free or only paid…

    required
    —
    optional
    —
  • reviews

    1 cr

    An app's user reviews with star rating, text, reviewer name and id, date, helpful votes, app…

    required
    —
    optional
    —
  • similar

    1 cr

    The store's Similar apps list for an app (the full list behind the detail page's Similar apps…

    required
    —
    optional
    —
  • developer

    1 cr

    Every app a developer publishes, with real paging.

    required
    —
    optional
    —
  • top_charts

    2 cr

    The store's top charts.

    required
    —
    optional
    —
  • categories

    0 cr

    The store's category ids and labels (apps, games, kids) accepted by top_charts.

    required
    —
    optional
    —
  • data_safety

    1 cr

    The app's full Data safety declaration as the store shows it.

    required
    —
    optional
    —
  • permissions

    1 cr

    The Android permissions the app asks for, grouped as the store groups them (Location, Camera,…

    required
    —
    optional
    —
  • suggest

    1 cr

    The search box's autocomplete suggestions for a partial query.

    required
    —
    optional
    —

Every parameter, every allowed value →

Missing a Google Play Store endpoint, or need a source we don't have yet?Contact us real people · same-day reply.
How it works

How the Google Play Store API works

Google Play Store is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.

Authenticate01
x-api-key header

No OAuth app, no request signing, no per-site account. One key covers all 694 engines.

Call02
POST /google-play/v1/…

Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.

Pay03
0 or 1 or 2 credits per call

Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.

Read04
{ ok, data, meta, error }

One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.

Recipe

From a chart to the apps, their users' complaints and their developers

Pick a category chart, read each listing, then read the critical reviews and the developer's other apps.

01top_charts?chart=top_grossing&category=GAME_PUZZLE&country=us&page_size=50
GET/google-play/v1/top_charts?chart=top_grossing&category=GAME_PUZZLE&country=us&page_size=50

The 50 top-grossing puzzle games, ranked, with installs, rating, price and description.

02details?app_id=com.block.juggle
GET/google-play/v1/details?app_id=com.block.juggle

Exact installs, rating histogram, version, Updated date, data safety, permissions and the developer's contact block.

03reviews?app_id=com.block.juggle&sentiment=critical&page_size=200
GET/google-play/v1/reviews?app_id=com.block.juggle&sentiment=critical&page_size=200

The critical reviews with the developer's replies; next_cursor for more.

04developer?developer=<developer.id
GET/google-play/v1/developer?developer=<developer.id
from details>

Every other app the same developer publishes.

A ranked list of apps in a niche with installs, ratings, user complaints and developer contacts, for any country.

request
curl -X POST https://api.reefapi.com/google-play/v1/details \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"app_id":"com.whatsapp"}'
response envelope
{
  "ok": true,
  "data": { … },
  "meta": {
    "api": "google-play",
    "endpoint": "details",
    "mode": "live",
    "latency_ms": …,
    "record_count": …
  },
  "error": null
}
Fields

What a Google Play field actually contains

Fields that read differently from how they look. Every row was measured against live Google Play pages on 2026-11-16.

FieldWhat it holds
installs, installs_short, min_installs, real_installsinstalls is the range the store prints ("10,000,000,000+"), installs_short the number over "Downloads" ("10B+", matched the page on 10 of 10 apps), min_installs its lower bound and real_installs the store's exact count behind it (WhatsApp: 12,504,378,625). real_installs was filled on 54 of 54 sampled apps.
rating, rating_text, ratings_count, reviews_countrating is the exact average (4.6272), rating_text the page's "4.6". ratings_count is the number the page prints as "248M reviews" — it counts star ratings, matched on 10 of 10 apps. reviews_count is the smaller count of written reviews (WhatsApp: 1,939,568).
histogramStar ratings per star, 1 to 5, as the store publishes them. Its sum can differ slightly from ratings_count (WhatsApp: 53 apart out of 247.9 million) — both are the store's own figures.
ratings_by_deviceThe rating the store shows per device tab (phone, tablet, watch, chromebook, tv, car) for the devices that app has ratings on.
price, currency, price_textThe price for the chosen country: Minecraft is USD 6.99 in us, EUR 6.99 in de, JPY 1,300 in jp, INR 40 in in, TRY 112.99 in tr and BRL 10.90 in br. price_text is the button text ("$6.99"); free apps have price 0 and no price_text. Matched the page's button on 10 of 10 apps.
version, android_min_versionEmpty when the store prints "Varies with device": version was published on 42 of 54 sampled apps, the minimum Android on 44 of 54.
developerThe listing's App support and About the developer blocks as published: name, numeric developer id, website, support e-mail, legal name, legal e-mail, address and phone. Support e-mail, legal name and address were on 54 of 54 sampled apps, a phone number on 50 of 54.
searched_forWhen the store cannot match a query it searches something else and says so; this field carries what it searched instead (null when it searched your words).

An app that does not exist, or is not offered in the chosen country, returns NOT_FOUND — also on reviews, similar, permissions and data_safety, never an empty list.

Coverage

Google Play coverage, measured

Every number below was read from the live Google Play store on 2026-11-16.

Listing accuracy

Compared with the store's own listing pages for 10 apps (free, paid, with and without ads): 70 of 70 values matched — downloads, rating, rating count, price button, Contains ads, In-app purchases and Updated date.

Fields

54 sampled apps from 12 category charts: installs, exact install count, rating, histogram, price, content rating, Updated date, developer e-mail, legal name and address on 54 of 54; version on 42 (the rest print "Varies with device"); developer phone on 50.

Lists

Search about 240-250 apps per query with paging (first page 18-30, second 20, then up to 50 per page); similar apps up to 50 per page (WhatsApp: 113); developer apps up to 50 per page (Google LLC: 123); top charts up to 200 places; reviews up to 200 per page.

Filters

Search: free or paid. Reviews: newest, most relevant or by rating; stars 1-5; positive or critical; phone, tablet, watch, chromebook, tv or car. Charts: top free, top paid, top grossing × 54 categories × any country.

Country and language

Any store country and language. Minecraft costs USD 6.99 in the US, EUR 6.99 in Germany, JPY 1,300 in Japan and BRL 10.90 in Brazil; the US and Japanese top-free charts share 11 of their top 50 apps.

Limits

No download size (the store no longer publishes it), no result counts for searches or filtered reviews, charts stop at 200 places, search at about 250 results. Nothing behind a Google login.

Use cases

What people build with Google Play Store

The jobs this data is most often used for.

01

Track installs, ratings and versions of competing apps and games, country by country.

02

Monitor top free, paid and grossing charts per category and country for new entrants.

03

Build lead lists of app developers with their published e-mail, address and phone.

04

Mine reviews by star, device and sentiment for bugs, feature requests and developer replies.

10

endpoints

0/1/2

credits per call

Pricing

What Google Play Store data costs

The cheapest call here is 0 credits, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.

$0.67–$1.50 / 1,000 credits
Full pricing →
  • 1,000 free credits on signup, no card
  • One key, all 694 APIs, one credit pool
  • Failed and blocked calls are never charged
  • Credits roll over and never expire
no credit card1,000 free credits · instant API key · pay by card or crypto
Quickstart

Call it in two lines

Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.

curl
curl -X POST https://api.reefapi.com/google-play/v1/details \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"app_id":"com.whatsapp"}'
python
import os
import requests

REEF_KEY = os.environ["REEF_KEY"]

r = requests.post(
    "https://api.reefapi.com/google-play/v1/details",
    headers={"x-api-key": REEF_KEY},
    json={
        "app_id": "com.whatsapp"
    },
    timeout=90,
)
print(r.json()["data"])
FAQ

Have a question? We got answers.

The questions people actually ask before wiring up Google Play Store.

Do I need a Google account?▾

No. Everything is read logged out from the public store.

Can I get the exact number of installs?▾

Yes. Besides the range the store prints ("500,000,000+"), details returns the store's exact count behind it (Duolingo: 997,312,259) — filled on 54 of 54 sampled apps.

Does it return developer e-mails, addresses and phone numbers?▾

Yes, exactly as the listing publishes them. On 2026-11-16 the support e-mail, legal name and postal address were on 54 of 54 sampled apps and a phone number on 50 of 54.

How many reviews can I get?▾

Up to 200 per page with a cursor for the next page; four pages of 50 for Spotify returned 200 different reviews. Sort newest, most relevant or by rating, and filter by stars (1-5), positive (4-5) or critical (1-3), and by device: phone, tablet, watch, chromebook, tv or car.

How deep does search go?▾

As deep as the store answers: about 240-250 apps per query with a cursor ('photo editor' 239, 'vpn' 250, 'calculator' 250, no duplicates). The first page holds the store's first 18-30 results, the second 20, every next page up to 50. The price filter returns only free or only paid apps.

Which countries and languages work?▾

Any store country by two-letter code and any store language. The country decides the catalogue, the charts and the currency (the US and German top-free charts shared 17 of their top 50 apps); the language decides the text and, for reviews, which reviews you see.

What do top charts cover?▾

Top free, top paid and top grossing for all apps, all games, every game genre and every app category, ranked, up to 200 places — the chart's full length. A few charts are empty in some countries (top paid Finance in the US); those return 0 rows with a note.

What is not available?▾

Anything behind a Google login (installing, your library, writing reviews), the app's download size (the store no longer publishes it) and a result count for searches or filtered reviews.

What is the Google Play Store API?▾

Google Play Store API is a ReefAPI endpoint group for google play apps and games as json: full listings with exact installs, rating histogram, price per country, developer contacts, data safety and permissions, plus search, reviews, similar apps, developer apps and top charts. It returns live JSON through POST requests under /google-play/v1.

Is the Google Play Store API free to try?▾

Yes. ReefAPI starts with 1,000 free credits, no card required. Google Play Store calls use the same shared credit balance as every other ReefAPI engine.

Do I need a Google Play Store login or account?▾

No login to Google Play Store is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.

How fresh is the Google Play Store data?▾

The page example is captured from a live details call, and production requests fetch live data through ReefAPI rather than a static sample.

How many credits does the Google Play Store API use?▾

Google Play Store actions currently cost 1-2 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.

Can I call Google Play Store from an AI assistant or MCP client?▾

Yes. Connect ReefAPI once through MCP and your assistant can call google-play actions with the same key, credit pool and JSON envelope used by normal REST requests.

Same key

17 Reputation & Reviews APIs on the same key

One key, one credit pool, one response envelope. If you are pulling Google Play Store, you are one call away from the rest of the category — no second contract, no second integration.

Contact

Need something this API does not do?

Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.

0/4000

No account needed · we reply from [email protected]

Try it on your own data before you pay anything

The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 693 APIs, and the same envelope everywhere.

Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-11-16.