Apps similar to a Google Play app: the full Similar apps list (3 to 50 apps, more than the strip on the details page) with paging. Every page costs 1 credit. The app list follows hl, but cluster_title is always English.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
3 optional filters available.
string
Required
Google Play package name of the app, for example com.openai.chatgpt.
com.openai.chatgpt
string
Optional
The next_page_token of the previous response. It is opaque, pass it back unchanged. Page 2 and later cost 1 credit.
example
string
Optional
Interface language code, for example en or de. Default: en.
en
string
Optional
Storefront country: US, GB, DE, FR, JP, BR or IN. Default: US. Other countries return 422.
us
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
pagination
product_id
result_count
cluster_title
organic_results
search_parameters
Common organic_results fields
free
link
price
title
{
"pagination": {
"next_page_token": "IABiswFKQAo-CDUQ9_Gpmw0QyoTGmAUQxZDPhw0Q0omtugwQhouMxAQQ_My9qgwQq-W1vwEQjc28_AcQ04rKywQQqfPhnQNQMmosenJ4ZWZ5cmZZYTRVcklzNFdRVmJxeFUzNzEwMjRXcTdqK1I4V0dzbVpEVT3CAjsKFgoSY29tLm9wZW5haS5jaGF0Z3B0EAcYCDABOABKFQgBEAAaB0NoYXRHUFQgACgAMAA4AFAAWAFgALASAA"
},
"product_id": "com.openai.chatgpt",
"result_count": 2,
"cluster_title": "Similar apps",
"organic_results": [
{
"free": true,
"link": "https://play.google.com/store/apps/details?id=com.google.android.youtube",
"price": {
"amount": 0,
"currency": "USD"
},
"title": "YouTube",
"rating": 3.824073,
"summary": "Get the official YouTube app on Android phones and tablets. See what the world is watching -- from the hottest music videos to what\u2019s pop...",
"category": "Video Players & Editors",
"installs": "10,000,000,000+",
"developer": "Google LLC",
"thumbnail": "https://play-lh.googleusercontent.com/QNmuZQc9I6Zbe3mWnSr0hycnENqGFCI5p3yE29Hkxtf22T0IWS6zTrpxULLyyjWpB7ONAXDsDQXnXcVWokl3eg",
"product_id": "com.google.android.youtube",
"rating_text": "3.8",
"screenshots": [
"https://play-lh.googleusercontent.com/jVRIwf6mm4cUtprTFhNOd4YEeu1jyO0yiZ92U3rlZ9ohVojYDc4ijfrdzy1ORbdXzu-pLS7gh5b8XmkSavyjtQ",
"https://play-lh.googleusercontent.com/Bgpxh4XK6pa2H26tDuNiviRmY8JSFsK4nlALuQkmwmGKltRm3g6_jt_aogLbvEmkh-O080dmyxIPeGDeVs8KkRQ"
],
"header_image": "https://play-lh.googleusercontent.com/_FjKDuJDbhlGIZN7h5rcVY3NfyP8PZATgR-0MKiYz8DeKofTecT57LU-TTlAGiX07vDBIaXDcZiafhHFU4pI1w",
"content_rating": "Teen",
"in_app_purchases": "$0.05 - $999.99 per item"
},
{
"free": true,
"link": "https://play.google.com/store/apps/details?id=com.google.android.apps.bard",
"price": {
"amount": 0,
"currency": "USD"
},
"title": "Google Gemini",
"rating": 4.5349,
"summary": "From your morning commute to late-night deep dives, Google Gemini is your personal, proactive and powerful AI assistant.WHY USERS LOVE GE...",
"category": "Productivity",
"installs": "1,000,000,000+",
"developer": "Google LLC",
"thumbnail": "https://play-lh.googleusercontent.com/C64IqPWyFoCZzXVxXVl0Y6mliiNlG_sZJsqul-SBvk9ZL0wJHlU0Eho2wvsBHhho0FT5XQtH55RVGerIwXF_MA",
"product_id": "com.google.android.apps.bard",
"rating_text": "4.5",
"screenshots": [
"https://play-lh.googleusercontent.com/74MknZbU3d5VzwctiFgk3bcDJEUqlN7r82DxiQjQppcCaPHS7qexvX-lb8KJlNv6975v4D0DcqZKeeS0PYtkxLA",
"https://play-lh.googleusercontent.com/cZKYOVwfa7n3InOwSnGf8_05N5nwYHDhQU5MNm1OlJ85AcaU8cYBnZSUDrMce3GsHIVgYM8JGz_OH2JWmem_"
],
"header_image": "https://play-lh.googleusercontent.com/fSnmF9td_e3wpG1trkbuFbusZR-MzOH3skC2oA2-Rgkx31fF7wXULdJG2EyZTFw0lKo7ZpaAn5PSaj_fUVV0fQ",
"content_rating": "Teen"
}
],
"search_parameters": {
"gl": "US",
"hl": "en",
"engine": "google_play_similar",
"product_id": "com.openai.chatgpt"
}
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A parameter failed validation, for example an unknown category, a num outside 1 to 200 or an unsupported country.
Similar Apps Not Found
The app is unknown or has no Similar apps list. The request is not billed.
{
"error": "No similar apps found for this product_id.",
"error_code": "google_play_similar_not_found"
}Invalid Page Token
The page_token was not accepted. The request is not billed.
{
"error": "The page_token was not accepted. Use next_page_token of the previous response.",
"error_code": "google_play_invalid_page_token"
}Google Play Upstream Unavailable
Google Play could not be fetched. The request is not billed.
{
"error": "Google Play data is temporarily unavailable.",
"retryable": true,
"error_code": "google_play_upstream_unavailable"
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.