API referenceGoogle Play
Google play search
Search the Play Store for apps by keyword.
Returns the store's result cluster (typically 20-30 apps) with, per hit, the package name, title, summary, icon, screenshots, developer, rating, installs, genre, content rating and price.
One call, one cluster: Play's web search reports an empty continuation token, so there is no page 2 to offer and none is pretended here. Narrow the query to reach different apps.
The example response below is real output from this endpoint, not an illustration. Long lists and long strings are shortened to keep the page readable, and each place that happens is marked. This example took 3.8s.
Authorization
ApiKeyAuth X-API-Key<token>
Your API key. Sent on every request.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/scrapers/google-play-search-v4" \ -H "Content-Type: application/json" \ -d '{ "query": "photo editor", "lang": "en", "country": "US" }'{ "request_id": "req_8f2c1d94e7b0", "success": true, "status": { "code": "OK", "message": "Scrape completed.", "retryable": false }, "data": { "country": "US", "lang": "en", "query": "photo editor", "results": [ { "app_id": "photo.editor.photoeditor.photoeditorpro", "content_rating": "Everyone", "currency": "USD", "developer": "InShot Inc.", "free": true, "genre": "Photography", "header_image": "https://play-lh.googleusercontent.com/XEtMTFEia70VEhFnytqHX6LhlwbedKrVsqVurmmuKiYw8pzz6WlRA21CZd_Dpcq0o9aS7FhxrJcDLM92r7HTKQ", "icon": "https://play-lh.googleusercontent.com/q-z-Sbn2WLCUb4MSmmdhVr9KRfJ4qTlgoQEUGEKsnfVEEMNPxsabpr-yngqQ15o5b6gLhaBOhGZNv6oBWDMl", "in_app_purchase_range": "$0.99 - $129.99 per item", "installs": "100,000,000+", "price": 0, "rating": 4.8012714, "rating_display": "4.8", "screenshots": [ "https://play-lh.googleusercontent.com/ox8GvQefGOS-w4mfrAOxZ99oGfV4N7QgxRmgEmNhDRA1Hwfzh2bFce8XIFgx0evOOtoU58Zybpl_cD6w4pOHKt0", "https://play-lh.googleusercontent.com/smFwjNuxaYfBlgtwDApZXZDno-U8UESuoqC4STAiuhe3lsjzuDEtz_zUnbsBBVX7x4RrnmsvNQ0N2R9M5Q3k_UM", "… 15 more items in the full response" ], "summary": "✨ Photo Editor & AI Photo Enhancer by InShot 🎉\nLooking for an easy photo editor to transform your pictures in seconds? Polish combines AI editing tools with powerful photo editing features to help you create stunning photos effortlessly.\n\nWhether you want to fix blurry pictures, remove unwanted objects, create AI portr… (+2180 chars)", "title": "Photo Editor - Polish", "url": "https://play.google.com/store/apps/details?id=photo.editor.photoeditor.photoeditorpro&hl=en&gl=US" }, { "app_id": "com.picsart.studio", "content_rating": "Teen", "currency": "USD", "developer": "PicsArt, Inc.", "free": true, "genre": "Photography", "header_image": "https://play-lh.googleusercontent.com/nY4APZoMuq7w6mrp93LkqIP0dDeiriBUfzqWb2buRGJnM7PDEXbSYP2_sFmeW6iMVr9EehI6nJnTIp9AYWiTmg", "icon": "https://play-lh.googleusercontent.com/wXk_X0uT6AeWv5TFfheHP8NrOmtz17BX-2uEZ7H4naTIzuFpSIfohvQTA4pKOCF71TmeUF3DfMAGq1SlK2hH7Qk", "in_app_purchase_range": "$0.99 - $219.99 per item", "installs": "1,000,000,000+", "price": 0, "rating": 3.9787517, "rating_display": "4.0", "screenshots": [ "https://play-lh.googleusercontent.com/2yKRa--Lqhyprf6XvsuMPyaT_kGns_WrGkSALifd9_vYb9t6INzCZdXD9QwjKCbldK0", "https://play-lh.googleusercontent.com/RH8lLb-HFnM6Y_cRnqb6HqpZghSnFCebNBnqAYYRfCZec8HzuT-RTxjS07M00ziYHE87KuPQ2fze2aZ9byy0Og", "… 21 more items in the full response" ], "summary": "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 … (+3677 chars)", "title": "Picsart AI Photo Editor, Video", "url": "https://play.google.com/store/apps/details?id=com.picsart.studio&hl=en&gl=US" }, "… 19 more items in the full response" ], "returned": 21 }, "error": null, "meta": { "client_id": "client_abc123", "scraper": "google-play-search-v4", "billable": true, "duration_ms": 2700 }}