Google Play Store API & Scraper
This API reads play.google.com logged out and returns what the store publishes as plain JSON.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
`details` takes a package name or store link and returns the install range and the exact install count, the average rating with the rating count, review count and the 1-5 star histogram, the rating per device type, price and currency for the chosen country, the in-app purchase range, Contains ads, content rating, version, Updated and Released dates, required Android, categories and tags, the chart rank, screenshots, video, What's new, the full description, the data-safety summary, the permissions and the developer block (name, id, website, support e-mail, legal name, address, phone). `search` works like the store's search box with its free / paid filter and pages through about 250 results. `reviews` returns reviews with stars, text, reviewer, date, helpful votes, app version and the developer's reply, sorted newest, most relevant or by rating and filtered by stars, positive or critical and device. `similar`, `developer` and `top_charts` (top free, top paid, top grossing for any category and country) return the store's own lists, and `data_safety` returns the full Data safety declaration.
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.
| Field | What it holds |
|---|---|
| installs, installs_short, min_installs, real_installs | installs 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_count | rating 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). |
| histogram | Star 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_device | The rating the store shows per device tab (phone, tablet, watch, chromebook, tv, car) for the devices that app has ratings on. |
| price, currency, price_text | The 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_version | Empty when the store prints "Varies with device": version was published on 42 of 54 sampled apps, the minimum Android on 44 of 54. |
| developer | The 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_for | When 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.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/google-play/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "photo editor"
}
}{
"ok": true,
"meta": {
"api": "google-play",
"endpoint": "search",
"mode": "live",
"latency_ms": 1296,
"record_count": 20,
"bytes": 197893,
"cache_hit": false,
"upstream_requests": 1,
"country": "us",
"language": "en",
"has_more": true,
"total_note": "the store publishes no match count; a query runs out after about 240-250 results",
"charged_credits": 2,
"version": "1.0.0",
"request_id": "582d86d606eb44da",
"queue_ms": 1.8,
"fetched_at": "2026-11-16T21:05:23.357Z"
},
"data": {
"query": "photo editor",
"searched_for": null,
"price": "all",
"count": 20,
"next_cursor": "eNp1UmFP2zAQ_StTvoKsUtCmVeKDCylUk9ACdDBNU3V1nPSI43PPThia9t9ntymo2vh293z33vOzf2eQTTKvgdU6O86a2LhxLEIsLmR-d1XUV7m8gfwZ4VQfPXgaf5e_Hp8ujxbz6_I0n-FmI5_OvnyVVBTfpsXi5PP97WJ2V4zW1SKfXd_ezynxvL9PeDmSUsmbM_lpPp3WlF_Iopb1-Xm0sUl-1hTogy4xEEfIRQiMiRVnk_HoOJrXNpv82M2J3ZzYNv_WjikuKmqFQ-WBg_ChK3EPQkkrLZxvaYVGJ7G0qsgYqPUB54C10GgelhXYHsSbz_fsVGiCZl9FN6hCx9ofqBs-VB-2DLxQF_6na7HxVIVnYC28BRfzKF8ttZrBY6nBC7Q-gI-U-wQSO1MSdu4wgHQSJ51gHQDNKxuXaMGsTKdTfvtcaqJ66zcN9V5R0h3apoeyZurcQLpNe_n2DDtB74Ab4eLx_k66YzCO0bcwQC3UqHoByCvufPqsvUcrwsnHZdVZ-7LcCkQYSVSgdLrUz_g7qmxiO2P-_AWFXwUy",
"items": [
{
"rank": 1,
"app_id": "photo.editor.photoeditor.photoeditorpro",
"title": "Photo Editor - Polish",
"link": "https://play.google.com/store/apps/details?id=photo.editor.photoeditor.photoeditorpro",
"developer": "InShot Inc.",
"category": "Photography",
"rating": 4.8023,
"rating_text": "4.8",
"installs": "100,000,000+",
"price": 0,
"price_micros": 0,
"currency": "USD",
"price_text": null,
"is_free": true,
"in_app_purchases": "$0.99 - $129.99 per item",
"content_rating": "Everyone",
"content_descriptors": null,
"interactive_elements": "In-App Purchases",
"description": "✨ Powerful Photo Editor for Every Moment 🎉\n\nLooking for an easy photo editor to transform your pictures in seconds? Polish gives you powerful yet simple tools to edit photos, apply filters and effects, make collages, retouch portraits, and remove unwanted objects.\n\nWhether you are creating social media posts, polishing selfies, or enhancing everyday moments, Polish helps you make beautiful photos quickly and save them in high quality. Join millions of users editing and sharing their favorite moments with Polish.\n\n📸 Everything You Need in a Photo Editor\n\nPhoto Filters & Effects\nExplore 100+ p",
"icon_url": "https://play-lh.googleusercontent.com/q-z-Sbn2WLCUb4MSmmdhVr9KRfJ4qTlgoQEUGEKsnfVEEMNPxsabpr-yngqQ15o5b6gLhaBOhGZNv6oBWDMl",
"header_image_url": "https://play-lh.googleusercontent.com/XEtMTFEia70VEhFnytqHX6LhlwbedKrVsqVurmmuKiYw8pzz6WlRA21CZd_Dpcq0o9aS7FhxrJcDLM92r7HTKQ",
"screenshots": [
"https://play-lh.googleusercontent.com/YYttByk4r8qdMR_Yfg0jWRv7sVFpbZrT55KWsy1URxkHZQF5rniwJEnT5M_ClAtxe524sP49d_P2L7Whn_wstD0",
"https://play-lh.googleusercontent.com/qVo6vivPaYiKZDEEJh8W6C0-l2YOmvG9g6UgvdJ7FFsXuX9-ZqpgGFXGDrhYLN_CAXpd1ua3aZF0dwlsli9w1vo",
"https://play-lh.googleusercontent.com/bwcZ25SPb0E_DkjKejL6ac6l4ugA57yY8pzX9b7tsSMABXMHrhvIdC4nbUfwn8ejvabFKPyQTZzPJpkDDuzuvQ"
]
},
{
"rank": 2,
"app_id": "com.picsart.studio",
"title": "Picsart AI Photo Editor, Video",
"link": "https://play.google.com/store/apps/details?id=com.picsart.studio",
"developer": "PicsArt, Inc.",
"category": "Photography",
"rating": 3.9232,
"rating_text": "3.9",
"installs": "1,000,000,000+",
"price": 0,
"price_micros": 0,
"currency": "USD",
"price_text": null,
"is_free": true,
"in_app_purchases": "$0.99 - $450.00 per item",
"content_rating": "Teen",
"content_descriptors": null,
"interactive_elements": "Users Interact, In-App Purchases",
"description": "Ignite your creative potential with Picsart — the all-in-one AI photo editor, AI video editor, and design studio that’s free and easy to use. From business designs to AI art, go from inspiration to creation fast. Create with an AI photo generator and AI video generator, edit with an AI image editor, remove backgrounds with Background Remover (BG remover), erase objects with Object Remover (Object Eraser), apply AI effects, filters, and retouch tools, and turn ideas into designs with templates, collages, story maker, and more. Create with new image-to-video tools, AI video avatars, AI try-on, A",
"icon_url": "https://play-lh.googleusercontent.com/wXk_X0uT6AeWv5TFfheHP8NrOmtz17BX-2uEZ7H4naTIzuFpSIfohvQTA4pKOCF71TmeUF3DfMAGq1SlK2hH7Qk",
"header_image_url": "https://play-lh.googleusercontent.com/nY4APZoMuq7w6mrp93LkqIP0dDeiriBUfzqWb2buRGJnM7PDEXbSYP2_sFmeW6iMVr9EehI6nJnTIp9AYWiTmg",
"screenshots": [
"https://play-lh.googleusercontent.com/VPZIP0d35c6XlgdJ0kYpXLWgAekNqyBNGpV7YPLBWloLj8-dQ_fTsUDStX4vGp1MTF69Ii5RW6bLAVCYN6MM",
"https://play-lh.googleusercontent.com/rSExZHnCVzgMcPgC4nhxBABD_gHEJ9CKOHakVun7OG_Ux2uJAJq4HohoZuRkuI5gnZrrW5TIMEoNlU5F8bKe",
"https://play-lh.googleusercontent.com/RH8lLb-HFnM6Y_cRnqb6HqpZghSnFCebNBnqAYYRfCZec8HzuT-RTxjS07M00ziYHE87KuPQ2fze2aZ9byy0Og"
]
},
{
"rank": 3,
"app_id": "com.adobe.psmobile",
"title": "Photoshop Express Photo Editor",
"link": "https://play.google.com/store/apps/details?id=com.adobe.psmobile",
"developer": "Adobe",
"category": "Photography",
"rating": 4.551,
"rating_text": "4.6",
"installs": "100,000,000+",
"price": 0,
"price_micros": 0,
"currency": "USD",
"price_text": null,
"is_free": true,
"in_app_purchases": "$2.99 - $99.99 per item",
"content_rating": "Everyone",
"content_descriptors": null,
"interactive_elements": "Users Interact, Digital Purchases",
"description": "PHOTO EDITING MADE FUN AND EASY\n\nTap into your creativity and capture the moment with a photo editor made for fun, fast, and easy one-tap photo edits. Trusted by millions, Photoshop Express is the picture editor perfect for turning creative ideas into reality. Add text to photos, touch up a selfie, and make pre-post edits using social media templates. Remove objects and replace backgrounds with AI, apply vibrant beauty filters and stickers, or match your aesthetic with nostalgic or vintage camera effects. Looking to make a collage? Create a photo collage of your favorite memories in seconds an",
"icon_url": "https://play-lh.googleusercontent.com/rCGZtLm-ksJ87FtI_3YsfYyQMLnv68_YoZsS_Ax0r8UvWrXSg3--vt7WR3iZsN-ImQSgMYz3RKQTCf5_eIiv1g",
"header_image_url": "https://play-lh.googleusercontent.com/zCfZQBDzeNHOENmL1D-ibxD9z0RjALAG3Op2e26tebZCU4p4NK6EEeRAsN8HAoIyfNNNA4qwtVb3otPocuCB",
"screenshots": [
"https://play-lh.googleusercontent.com/QrskoSwzuRO9_KZVwaeG-bi_1mti802Pm4moBNMlND1Ypt0-_lCTfcumFGgMSh7BWcGogKBD99FrigeQEW-1-g",
"https://play-lh.googleusercontent.com/Njpsbxub-BJh7wHdq52IWlgOQ4YIym_rLhB9wOp3dhcRK3qqy9XmhuWQL-ljYF9dgxip59zfdehLT6eGwQYa_Q",
"https://play-lh.googleusercontent.com/npGpe_xIMXbxRHSgCVoLL0VEGapk4Ft5glbCV586Wx0M2Xz6nx92jRJGDWVTROMiXQzEfqtPBuD-L2-TbU4dlQ"
]
}
]
}
}What the Google Play Store API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| details | 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. | Support teams call details to get everything the store page shows about one app or game. | none |
| search | 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. | Reputation platforms call search to search the Play Store like its search box (apps and games), optionally only free or only paid…. | none |
| reviews | 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. | Market researchers call reviews to get an app's user reviews with star rating, text, reviewer name and id, date, helpful votes, app…. | none |
| similar | The store's Similar apps list for an app (the full list behind the detail page's Similar apps shelf), with real paging. | B2B review analysts call similar to get the store's Similar apps list for an app (the full list behind the detail page's Similar apps…. | none |
| developer | 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). | Support teams call developer to get every app a developer publishes, with real paging. | none |
| top_charts | 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). | Reputation platforms call top_charts to get the store's top charts. | none |
| categories | The store's category ids and labels (apps, games, kids) accepted by top_charts. No live request. | Market researchers call categories to get the store's category ids and labels (apps, games, kids) accepted by top_charts. | none |
| data_safety | 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 …). | B2B review analysts call data_safety to get the app's full Data safety declaration as the store shows it. | none |
| permissions | The Android permissions the app asks for, grouped as the store groups them (Location, Camera, Other …). | Support teams call permissions to get the Android permissions the app asks for, grouped as the store groups them (Location, Camera,…. | none |
| suggest | The search box's autocomplete suggestions for a partial query. | Reputation platforms call suggest to get the search box's autocomplete suggestions for a partial query.. | none |
Call search from your stack
curl -X POST https://api.reefapi.com/google-play/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"photo editor"}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/google-play/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "photo editor"
},
timeout=90,
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/google-play/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "photo editor"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.google-play.search with {"query":"photo editor"}.Who uses this API and why
- Track installs, ratings and versions of competing apps and games, country by country.
- Monitor top free, paid and grossing charts per category and country for new entrants.
- Build lead lists of app developers with their published e-mail, address and phone.
- Mine reviews by star, device and sentiment for bugs, feature requests and developer replies.
- Audit permissions and Data safety declarations across a category for privacy research.
Questions developers ask before integrating
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.