{"openapi":"3.1.0","info":{"title":"API.SH: Google Play","version":"1.0.0","description":"The Google Play API from API.SH: public Google Play data as clean JSON. Every endpoint is a GET with query parameters and your key in the x-api-key header. Calls that run cost the credits shown (x-credits): successes, and lookups that found nothing (404). Refused calls and errors on our side are free. Docs: https://api.sh/docs · Every platform: https://api.sh/openapi.json","contact":{"name":"API.SH support","email":"support@api.sh","url":"https://api.sh/contact"},"termsOfService":"https://api.sh/legal/terms"},"servers":[{"url":"https://api.api.sh"}],"security":[{"apiKey":[]}],"tags":[{"name":"Account","description":"Your balance, usage, logs and past responses. Free."},{"name":"Google Play","description":"10 endpoints (search & seo)","x-slug":"google-play","x-domains":["play.google.com"]}],"paths":{"/v1/account":{"get":{"operationId":"getAccount","tags":["Account"],"summary":"Balance, plan, spend and spend limits","description":"Credits by bucket (free monthly, plan, pay-as-you-go), the plan, credits spent today and this month (UTC), your spend limits and the key used. Free: costs no credits.","responses":{"200":{"description":"Account","content":{"application/json":{"example":{"success":true,"account":{"id":"8f0c…","status":"active","unlimited":false},"credits":{"total":41250,"free":100,"plan":0,"payg":41150,"free_resets_at":"2026-11-01T00:00:00Z"},"plan":null,"spend":{"today":120,"this_month":3400,"daily_limit":5000,"monthly_limit":null,"period":"UTC"},"key":{"id":"…","name":"production","prefix":"ash_li","created_at":"2026-10-01T00:00:00Z"}}}}},"401":{"description":"Missing, invalid, revoked or expired API key. Not charged. See https://api.sh/docs/errors#401","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/account/usage":{"get":{"operationId":"getAccountUsage","tags":["Account"],"summary":"Usage per day and per endpoint","description":"Calls, errors and credits per UTC day, and the top endpoints by credits. Free. Add output=csv for the daily rows as CSV.","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":90,"default":30}},{"$ref":"#/components/parameters/output"}],"responses":{"200":{"description":"Usage","content":{"application/json":{"schema":{"type":"object"}},"text/csv":{"schema":{"type":"string"}}}},"401":{"description":"Missing, invalid, revoked or expired API key. Not charged. See https://api.sh/docs/errors#401","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/account/logs":{"get":{"operationId":"listAccountLogs","tags":["Account"],"summary":"Your calls of the last 30 days","description":"Newest first. Filter by status, route prefix, key or time; page with `before` (the `next` value). Add output=csv|ndjson to download (up to 5,000 rows per request; the next cursor is in the x-next-cursor header). Free.","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":500,"default":50}},{"name":"status","in":"query","required":false,"description":"ok, error, or an HTTP status like 502.","schema":{"type":"string"}},{"name":"route","in":"query","required":false,"description":"Route prefix, e.g. /tiktok/v1","schema":{"type":"string"}},{"name":"key","in":"query","required":false,"description":"Only calls made with this key id.","schema":{"type":"string","format":"uuid"}},{"name":"since","in":"query","required":false,"description":"ISO time.","schema":{"type":"string","format":"date-time"}},{"name":"before","in":"query","required":false,"description":"Cursor from `next`.","schema":{"type":"string"}},{"$ref":"#/components/parameters/output"}],"responses":{"200":{"description":"Calls","content":{"application/json":{"schema":{"type":"object"}},"text/csv":{"schema":{"type":"string"}},"application/x-ndjson":{"schema":{"type":"string"}}}},"401":{"description":"Missing, invalid, revoked or expired API key. Not charged. See https://api.sh/docs/errors#401","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/results/{request_id}":{"get":{"operationId":"getResult","tags":["Account"],"summary":"Fetch a past response again, free","description":"The exact response a call returned, for 30 days after the call, at no cost. Use the call's x-request-id. Supports output=csv|ndjson.","parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"$ref":"#/components/parameters/output"},{"$ref":"#/components/parameters/records"}],"responses":{"200":{"description":"The stored response (headers: x-refetch: 1, x-original-time, x-original-route).","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Not found, or not public. A lookup that ran costs the endpoint's price (credits_used says); an unknown route is free.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"Older than 30 days.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/google-play/v1/app":{"get":{"operationId":"googlePlayApp","summary":"Google Play app details","description":"Every response includes `credits_used`: the credits this call cost.\n\nPrice: 2 credits per successful call. Docs: https://api.sh/docs/google-play-app","tags":["Google Play"],"x-credits":2,"parameters":[{"name":"app_id","in":"query","required":true,"schema":{"type":"string"},"example":"com.instagram.android"},{"name":"country","in":"query","required":false,"description":"Two-letter country.","schema":{"type":"string"},"example":"us"},{"name":"lang","in":"query","required":false,"description":"Language code.","schema":{"type":"string"},"example":"en"},{"$ref":"#/components/parameters/raw"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/fresh"},{"$ref":"#/components/parameters/output"},{"$ref":"#/components/parameters/records"}],"responses":{"200":{"description":"The data as JSON (or CSV / NDJSON with `output`).","headers":{"x-request-id":{"$ref":"#/components/headers/x-request-id"},"x-credits-used":{"$ref":"#/components/headers/x-credits-used"},"x-credits-remaining":{"$ref":"#/components/headers/x-credits-remaining"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"example":{"app_id":"com.spotify.music","name":"Spotify: Music and Podcasts","description":"Listen to songs, play podcasts, create playlists and discover music you'll love","category":"MUSIC_AND_AUDIO","developer":"Spotify AB","rating":"4.349167346954346","review_count":"36589573","price":null,"url":"https://play.google.com/store/apps/details/Spotify_Music_and_Podcasts?id=com.spotify.music&hl=en","title":"Spotify: Music and Podcasts","summary":"Listen to songs, play podcasts, create playlists and discover music you'll love","description_html":"With the Spotify music and podcast app, you can play millions of songs, albums and original podcasts for free. We have even added audiobooks…","installs":"1,000,000,000+","min_installs":1000000000,"real_installs":3182125940,"installs_short":"1B+","score":4.3491673,"score_text":"4.3","ratings":36589573,"reviews":1858134,"histogram":{"1":3720153,"2":1068538,"3":1310363,"4":3106703,"5":27383792},"price_value":0,"currency":"USD","free":true,"in_app_purchases":"$4.99 - $203.88 per item","contains_ads":true,"icon":"https://play-lh.googleusercontent.com/IzQgYCcnCFCD08GR-3bdtcT8xzOvrNkC84avGT5CwTX2VIqmTmKKJcP_Cd4JoBOdmCMlTndlOzV6hrthg2fOWA","header_image":"https://play-lh.googleusercontent.com/WdedaGD6EAXZgy88wZM97aIcenQ5Cqzu_IUWBMMalkZmVe2lhv_3YqIUh-6pFqLv27kZ44cQX3qxyZTXHH-S91Q","screenshots":["https://play-lh.googleusercontent.com/c1jnjL-9CIFlwlTMX3xNyeo8aEH39sNuC5zpTHhfW8keGxQE3TBMRX9Rm3VqM3E03Cyl9AqtnxuKvxJpcW0WCA","https://play-lh.googleusercontent.com/YxWsaNLSEBvLh04geMOADhSq6Ln5LmRrpa51ixZ7YkcEwmPQ-wdtnvoZDjVAgufbi2et0IlTVDAsvCCmlsJYnNA","… 38 more"],"video":null,"video_image":null,"content_rating":"Teen","content_rating_description":null,"developer_name":"Spotify AB","developer_url":"https://play.google.com/store/apps/developer?id=Spotify+AB","developer_id":"Spotify AB","developer_email":"name@example.com","developer_website":"https://www.spotify.com","developer_address":null,"privacy_policy":"https://www.spotify.com/legal/privacy-policy/","…":"10 more fields","cached":false,"credits_used":2}},"text/csv":{"schema":{"type":"string"}},"application/x-ndjson":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"404":{"$ref":"#/components/responses/E404"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}}}},"/google-play/v1/categories":{"get":{"operationId":"googlePlayCategories","summary":"Google Play categories","description":"The store's app and game categories: id (the value for `category` on /google-play/v1/charts), name, group (apps, games, kids) and category page link.\n\nEvery response includes `credits_used`: the credits this call cost.\n\nPrice: 1 credit per successful call. Docs: https://api.sh/docs/google-play-categories","tags":["Google Play"],"x-credits":1,"parameters":[{"name":"type","in":"query","required":false,"description":"all (default), apps or games.","schema":{"type":"string","enum":["all","apps","games"]}},{"$ref":"#/components/parameters/raw"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/fresh"},{"$ref":"#/components/parameters/output"},{"$ref":"#/components/parameters/records"}],"responses":{"200":{"description":"The data as JSON (or CSV / NDJSON with `output`).","headers":{"x-request-id":{"$ref":"#/components/headers/x-request-id"},"x-credits-used":{"$ref":"#/components/headers/x-credits-used"},"x-credits-remaining":{"$ref":"#/components/headers/x-credits-remaining"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"example":{"type":"all","count":52,"categories":[{"id":"ART_AND_DESIGN","name":"Art & Design","group":"apps","url":"https://play.google.com/store/apps/category/ART_AND_DESIGN"},{"id":"AUTO_AND_VEHICLES","name":"Auto & Vehicles","group":"apps","url":"https://play.google.com/store/apps/category/AUTO_AND_VEHICLES"},"… 50 more"],"note":"Use the id as `category` on /google-play/v1/charts.","cached":false,"credits_used":1}},"text/csv":{"schema":{"type":"string"}},"application/x-ndjson":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"404":{"$ref":"#/components/responses/E404"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}}}},"/google-play/v1/charts":{"get":{"operationId":"googlePlayCharts","summary":"Google Play top charts","description":"Google Play's top charts for a category and country: top free, top paid or top grossing apps and games, ranked, with title, developer, icon, rating, price, genre, installs and screenshots.\n\nEvery response includes `credits_used`: the credits this call cost.\n\nPrice: 1 credit per successful call. Docs: https://api.sh/docs/google-play-charts","tags":["Google Play"],"x-credits":1,"parameters":[{"name":"collection","in":"query","required":false,"description":"topselling_free (default), topselling_paid or topgrossing.","schema":{"type":"string","enum":["topselling_free","topselling_paid","topgrossing"]},"example":"topgrossing"},{"name":"category","in":"query","required":false,"description":"APPLICATION (all apps, default), GAME (all games), or a category such as GAME_PUZZLE, GAME_ACTION, SOCIAL, FINANCE, PRODUCTIVITY, HEALTH_AND_FITNESS, SHOPPING, TOOLS, EDUCATION, ENTERTAINMENT, FAMILY.","schema":{"type":"string"},"example":"GAME"},{"name":"country","in":"query","required":false,"description":"Two-letter country code (default us).","schema":{"type":"string"},"example":"us"},{"name":"lang","in":"query","required":false,"description":"Language code (default en).","schema":{"type":"string"},"example":"en"},{"name":"limit","in":"query","required":false,"description":"Apps to return, 1-200 (default 50).","schema":{"type":"integer"},"example":"50"},{"$ref":"#/components/parameters/raw"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/fresh"},{"$ref":"#/components/parameters/output"},{"$ref":"#/components/parameters/records"}],"responses":{"200":{"description":"The data as JSON (or CSV / NDJSON with `output`).","headers":{"x-request-id":{"$ref":"#/components/headers/x-request-id"},"x-credits-used":{"$ref":"#/components/headers/x-credits-used"},"x-credits-remaining":{"$ref":"#/components/headers/x-credits-remaining"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"example":{"collection":"topgrossing","category":"GAME","country":"us","lang":"en","count":50,"apps":[{"rank":1,"app_id":"com.scopely.monopolygo","title":"MONOPOLY GO!","url":"https://play.google.com/store/apps/details?id=com.scopely.monopolygo","developer":"Scopely","icon":"https://play-lh.googleusercontent.com/AUGFPG5XqzHukTUDH2mcdOTpEwlDmZ5hUuWPXwu9IcvcyaBTwhV2WJeKKFAj_UA2m05ZxPgJuhrllXIqlW0i","summary":"Hit GO! Roll the dice! Earn MONOPOLY money, interact with your friends, family members and fellow Tycoons from around the world as you explo…","score":4.594595,"score_text":"4.6","price":0,"currency":"USD","free":true,"price_text":"","genre":"Board","installs":"100,000,000+","content_rating":"Everyone","in_app_purchases":"$0.99 - $199.99 per item","screenshots":["https://play-lh.googleusercontent.com/W7W9i-KrZFiBv-gBjhDhYSjkpq8tGL9lX8TdE320ZMD2jN16vwEbIMfORnRIDrHUqDkxx7RJCCqUiNFerupMtw","https://play-lh.googleusercontent.com/UPjy_1HMHDid_FPGe98oX4GxvslA-tQne_V4pRiGSnqQu2KMVrD0HyERr7-tME1rO6RFgvaAhgBAN9AiDwJFYdo","… 22 more"],"header_image":"https://play-lh.googleusercontent.com/GoMgqxehn9nWe4zexp6vDkVvcHCDwavAdNe25zcliNGSqDjwAZ8jaQGWzwcjWXHqwLo1UQB5XGCuQ1-xIMbGKA"},{"rank":2,"app_id":"com.roblox.client","title":"Roblox","url":"https://play.google.com/store/apps/details?id=com.roblox.client","developer":"Roblox Corporation","icon":"https://play-lh.googleusercontent.com/QqZj22aXblAyYDxLQw-Gg0ycW0QkKhrDnwqgERZU9BMRXZnMlgXfq-94sikG5mEpt_I0lzZxcUzfLblmQgwYzUE","summary":"ROBLOX – MILLIONS OF GAMES ACROSS EVERY GENRE. PLAY FREE.<br><br>Roblox is home to every kind of game, for every kind of player. Compete in …","score":4.231771,"score_text":"4.2","price":0,"currency":"USD","free":true,"price_text":"","genre":"Adventure","installs":"1,000,000,000+","content_rating":"Teen","in_app_purchases":"$0.50 - $199.99 per item","screenshots":["https://play-lh.googleusercontent.com/bHynJCCjTZyc9Lqqx45O5GLX3sWAupY9mSqYn7wndPkwuB4A28txE7NKIpteQ_4t1kGvsRWKRuYiToYTYLtVSg","https://play-lh.googleusercontent.com/Ob7DYuH9C0lvBrjfj0snNOypxuz-hW_g1P9qYSSvdktRXp_rliceDx2fy0IZbc8vka48CN5gVyC3BGUj1kgaAg","… 32 more"],"header_image":"https://play-lh.googleusercontent.com/POelWkaCZ0mSaCrYISBjWACiR_O_qs-A-8EgA9P_nPk59ppnJELjfuCm8wXHcihJ1qKIsKLZrG0cp7oEloIALg"},"… 48 more"],"cached":false,"credits_used":1}},"text/csv":{"schema":{"type":"string"}},"application/x-ndjson":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"404":{"$ref":"#/components/responses/E404"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}}}},"/google-play/v1/data-safety":{"get":{"operationId":"googlePlayDataSafety","summary":"Google Play data safety","description":"An app's data safety section: the data shared with other companies and the data collected, by category (location, personal info, financial info...) with each data type, whether it is optional and its purposes, the security practices (encryption in transit, deletion requests...), the developer's contact details and privacy policy.\n\nEvery response includes `credits_used`: the credits this call cost.\n\nPrice: 1 credit per successful call. Docs: https://api.sh/docs/google-play-data-safety","tags":["Google Play"],"x-credits":1,"parameters":[{"name":"app_id","in":"query","required":true,"description":"A Google Play package name or store link.","schema":{"type":"string"},"example":"com.spotify.music"},{"name":"lang","in":"query","required":false,"description":"Language (default en).","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"Two-letter country (default us).","schema":{"type":"string"}},{"$ref":"#/components/parameters/raw"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/fresh"},{"$ref":"#/components/parameters/output"},{"$ref":"#/components/parameters/records"}],"responses":{"200":{"description":"The data as JSON (or CSV / NDJSON with `output`).","headers":{"x-request-id":{"$ref":"#/components/headers/x-request-id"},"x-credits-used":{"$ref":"#/components/headers/x-credits-used"},"x-credits-remaining":{"$ref":"#/components/headers/x-credits-remaining"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"example":{"app_id":"com.spotify.music","title":"Spotify: Music and Podcasts","lang":"en","country":"us","declared":true,"developer":"Spotify AB","developer_email":"name@example.com","developer_website":"https://www.spotify.com","developer_address":"Regeringsgatan 19\n111 53 Stockholm\nSweden","developer_phone":"+1 555 010 0000","privacy_policy":"https://www.spotify.com/legal/privacy-policy/","data_shared":[{"category":"Device or other IDs","summary":"Device or other IDs","data_types":[{"type":"Device or other IDs","optional":false,"purposes":["Advertising or marketing","Fraud prevention, security, and compliance"]}]},{"category":"Personal info","summary":"Other info","data_types":[{"type":"Other info","optional":false,"purposes":["Analytics"]}]},"… 1 more"],"data_shared_note":"Data that may be shared with other companies or organizations","data_collected":[{"category":"Device or other IDs","summary":"Device or other IDs","data_types":[{"type":"Device or other IDs","optional":false,"purposes":["App functionality","Analytics","… 4 more"]}]},{"category":"Contacts","summary":"Contacts","data_types":[{"type":"Contacts","optional":true,"purposes":["App functionality","Fraud prevention, security, and compliance","… 1 more"]}]},"… 7 more"],"data_collected_note":"Data this app may collect","security_practices":[{"practice":"Data is encrypted in transit","details":"Your data is transferred over a secure connection"},{"practice":"You can request that data be deleted","details":"The developer provides a way for you to request that your data be deleted"}],"url":"https://play.google.com/store/apps/datasafety?id=com.spotify.music","cached":false,"credits_used":1}},"text/csv":{"schema":{"type":"string"}},"application/x-ndjson":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"404":{"$ref":"#/components/responses/E404"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}}}},"/google-play/v1/developer":{"get":{"operationId":"googlePlayDeveloper","summary":"Google Play developer apps","description":"Every app of a Google Play developer, by developer name or numeric developer id (or a developer page URL), with each app cards data. Every response includes `credits_used`: the credits this call cost.\n\nPrice: 1 credit per successful call. Docs: https://api.sh/docs/google-play-developer","tags":["Google Play"],"x-credits":1,"parameters":[{"name":"id","in":"query","required":true,"description":"Developer name (Google LLC) or numeric developer id.","schema":{"type":"string"},"example":"Google LLC"},{"name":"lang","in":"query","required":false,"description":"e.g. en.","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"e.g. us.","schema":{"type":"string"}},{"$ref":"#/components/parameters/raw"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/fresh"},{"$ref":"#/components/parameters/output"},{"$ref":"#/components/parameters/records"}],"responses":{"200":{"description":"The data as JSON (or CSV / NDJSON with `output`).","headers":{"x-request-id":{"$ref":"#/components/headers/x-request-id"},"x-credits-used":{"$ref":"#/components/headers/x-credits-used"},"x-credits-remaining":{"$ref":"#/components/headers/x-credits-remaining"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"example":{"developer_id":"Google LLC","name":"Google LLC","url":"https://play.google.com/store/apps/developer?id=Google+LLC","lang":"en","country":"us","count":20,"apps":[{"app_id":"com.android.chrome","url":"https://play.google.com/store/apps/details?id=com.android.chrome","title":"Google Chrome","icon":"https://play-lh.googleusercontent.com/gbkzfC3R1fXcGR4Uag1uRSN_123Tpo_KxhVZFLFCatmthFuO1bzPczUomFtxI42YYEQMJeAaZuIFVrTF58gZYg","screenshots":["https://play-lh.googleusercontent.com/KD5K5P7NGPIM-VgTfotzKClfOPvPsImnQaC_LoOp0y-kFPq2QkVPQbA6neP60-NdbTTmzmFEh22yfjdYr6lchr8","https://play-lh.googleusercontent.com/3UAdULVMi4cAy4Csf6SIwn1Iml2CGr3ZpGS5B7Q5ER7dUAziKTtnYcKUqliI7FKeCUsE4FE5I2qRGOCH57Dt4Ls","… 31 more"],"score":4.1161757,"score_text":"4.1","genre":"Communication","price_value":0,"currency":"USD","description":"Chrome helps you do what’s possible on the web. Choose the fast, secure browser by Google.<br><br>GET THE BEST OF GOOGLE IN CHROME<br><br>• …","developer":"Google LLC","installs":"10,000,000,000+","header_image":"https://play-lh.googleusercontent.com/YMfJtIN2w7hSuWXbQaB7D7TTE3zK9V0wMY2gly40Z-SawmfwqzFUe57abguyLLUqW-xjAzt8q3i3efUTgUTdag","content_rating":"Everyone","in_app_purchases":null},{"app_id":"com.google.android.apps.messaging","url":"https://play.google.com/store/apps/details?id=com.google.android.apps.messaging","title":"Google Messages","icon":"https://play-lh.googleusercontent.com/Ndfiaudmk4fiveYNm5Gsnso8gFcvLeskQUdwgh9yNnOghIH0LN-Hth_yAMsY2TxN1u9jleiOX6Y81Wh5Vy5M","screenshots":["https://play-lh.googleusercontent.com/dJC3zlDZiX3gIEhOxE59Zu52g-qonUqnQJOfjrDYdjwpqQc4tLREUrW7YaLIhEjg6uh8YUDNZqK1N133tZkaw4M","https://play-lh.googleusercontent.com/XDlJOCEG_R_xQpjzRmCLrAALnhH9jyI7OHNYAvy5RiH94V_Nzt93c3flMhUiWXfibcDR64FxfLM6zNJjQVt34w","… 11 more"],"score":4.588666,"score_text":"4.6","genre":"Communication","price_value":0,"currency":"USD","description":"Google Messages is the official Google app for messaging. Google Messages is revolutionizing how a billion users connect and is powered by R…","developer":"Google LLC","installs":"10,000,000,000+","header_image":"https://play-lh.googleusercontent.com/ItBV4d13CkklhE7neJDJlffCJQBZEY6iHdg6LwJUAwnTuRln9TdBV5z3Jq1t7YLB5hBz3WCL-wv55Etj-bch","content_rating":"Everyone","in_app_purchases":null},"… 18 more"],"cached":false,"credits_used":1}},"text/csv":{"schema":{"type":"string"}},"application/x-ndjson":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"404":{"$ref":"#/components/responses/E404"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}}}},"/google-play/v1/permissions":{"get":{"operationId":"googlePlayPermissions","summary":"Google Play app permissions","description":"The Android permissions an app asks for, grouped as the store shows them (Location, Camera, Storage, Phone, Other...) with each group's permissions, plus a flat list.\n\nEvery response includes `credits_used`: the credits this call cost.\n\nPrice: 1 credit per successful call. Docs: https://api.sh/docs/google-play-permissions","tags":["Google Play"],"x-credits":1,"parameters":[{"name":"app_id","in":"query","required":true,"description":"A Google Play package name or store link.","schema":{"type":"string"},"example":"com.spotify.music"},{"name":"lang","in":"query","required":false,"description":"Language (default en).","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"Two-letter country (default us).","schema":{"type":"string"}},{"$ref":"#/components/parameters/raw"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/fresh"},{"$ref":"#/components/parameters/output"},{"$ref":"#/components/parameters/records"}],"responses":{"200":{"description":"The data as JSON (or CSV / NDJSON with `output`).","headers":{"x-request-id":{"$ref":"#/components/headers/x-request-id"},"x-credits-used":{"$ref":"#/components/headers/x-credits-used"},"x-credits-remaining":{"$ref":"#/components/headers/x-credits-remaining"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"example":{"app_id":"com.spotify.music","lang":"en","country":"us","count":27,"groups":[{"group":"Identity","icon":"https://play-lh.googleusercontent.com/AUs-Fih7eEfuhp-4lYGGK65UvYQ2K6qaKi0dRUipSmiac-QL94IbT-XylwOgMoaYBDLuGOz1l5Yn_K6z1NM","permissions":["find accounts on the device"],"type":"perm_identity"},{"group":"Contacts","icon":"https://play-lh.googleusercontent.com/c5fJsmDZCeHY1tZmeGXL12sHi8herULd72A_egjaAHylmgM-4gLiw4CuDJSzNnK5q8yxAAy4RyxtkdYzcg","permissions":["find accounts on the device"],"type":"contacts"},"… 9 more"],"other_permissions":["read TV channel/program information","write TV channel/program information","… 1 more"],"permissions":["find accounts on the device","approximate location (network-based)","… 25 more"],"cached":false,"credits_used":1}},"text/csv":{"schema":{"type":"string"}},"application/x-ndjson":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"404":{"$ref":"#/components/responses/E404"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}}}},"/google-play/v1/reviews":{"get":{"operationId":"googlePlayReviews","summary":"Google Play reviews","description":"Pass `next_cursor` back as `cursor` for the next 40 reviews. `next_cursor` is null on the last page. The response echoes `sort`, `rating` and `device`.\n\nEvery response includes `credits_used`: the credits this call cost.\n\nPrice: 1 credit per successful call. Docs: https://api.sh/docs/google-play-reviews","tags":["Google Play"],"x-credits":1,"parameters":[{"name":"app_id","in":"query","required":true,"description":"Google Play package name.","schema":{"type":"string"},"example":"com.instagram.android"},{"name":"cursor","in":"query","required":false,"description":"Cursor from `next_cursor` on the previous response; `next_cursor` is null on the last page.","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"Two-letter country.","schema":{"type":"string"},"example":"us"},{"name":"lang","in":"query","required":false,"description":"Language code.","schema":{"type":"string"},"example":"en"},{"name":"sort","in":"query","required":false,"description":"Review order: `newest` (default), `relevance` (most relevant) or `rating` (highest rated first).","schema":{"type":"string","enum":["newest","relevance","rating"]}},{"name":"rating","in":"query","required":false,"description":"Only reviews with this many stars (1-5).","schema":{"type":"integer"}},{"name":"device","in":"query","required":false,"description":"Only reviews written on this device type.","schema":{"type":"string","enum":["phone","tablet","watch","chromebook"]}},{"$ref":"#/components/parameters/raw"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/fresh"},{"$ref":"#/components/parameters/output"},{"$ref":"#/components/parameters/records"}],"responses":{"200":{"description":"The data as JSON (or CSV / NDJSON with `output`).","headers":{"x-request-id":{"$ref":"#/components/headers/x-request-id"},"x-credits-used":{"$ref":"#/components/headers/x-credits-used"},"x-credits-remaining":{"$ref":"#/components/headers/x-credits-remaining"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"example":{"app_id":"com.instagram.android","lang":"en","country":"us","next_cursor":"CtIBIskBAV8d1P2xjlwLBN__ijGi7xcMxfZWgvwRv8olbj5jJmEOqYNF2881y-LFZ_ffiX6BQnOqI0YU_I0Z3l8YBXGjIwezKLapOVp90YAmbYLZP61Tt0WufozaqnEiA_sRDbq9ro9r…","reviews":[{"review_id":"c2a82777-949e-444d-bd6e-4603c45c80c3","user_name":"siddhu shyleshwar","content":"super","score":5,"thumbs_up":185,"at":1791941045,"user_image":"https://play-lh.googleusercontent.com/a-/ALV-UjVuPz6IW9v4Lbsw7gIBksscX6LGV7barNHzH5KlChVKH1mxWELR","date":"2026-10-14T01:24:05.000Z","reply_content":null,"reply_at":null,"app_version":"450.0.0.50.77"},{"review_id":"d586d5fd-4efe-48a6-b439-8accb85dd6bd","user_name":"Shivam Dangi","content":"king","score":3,"thumbs_up":61,"at":1791941022,"user_image":"https://play-lh.googleusercontent.com/a-/ALV-UjVLEb-xPFpxKkm96pjpDgP3Ujf9wQ_lXFuSUVmnc4XiUR8PNoA","date":"2026-10-14T01:23:42.000Z","reply_content":null,"reply_at":null,"app_version":"449.0.0.52.84"},"… 38 more"],"credits_used":1,"cached":false}},"text/csv":{"schema":{"type":"string"}},"application/x-ndjson":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"404":{"$ref":"#/components/responses/E404"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}}}},"/google-play/v1/search":{"get":{"operationId":"googlePlaySearch","summary":"Google Play search","description":"The store embeds one page of apps. `next_cursor` is null.\n\nEvery response includes `credits_used`: the credits this call cost.\n\nPrice: 2 credits per successful call. Docs: https://api.sh/docs/google-play-search","tags":["Google Play"],"x-credits":2,"parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"},"example":"instagram"},{"name":"country","in":"query","required":false,"description":"Two-letter country.","schema":{"type":"string"},"example":"us"},{"name":"lang","in":"query","required":false,"description":"Language code.","schema":{"type":"string"},"example":"en"},{"$ref":"#/components/parameters/raw"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/fresh"},{"$ref":"#/components/parameters/output"},{"$ref":"#/components/parameters/records"}],"responses":{"200":{"description":"The data as JSON (or CSV / NDJSON with `output`).","headers":{"x-request-id":{"$ref":"#/components/headers/x-request-id"},"x-credits-used":{"$ref":"#/components/headers/x-credits-used"},"x-credits-remaining":{"$ref":"#/components/headers/x-credits-remaining"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"example":{"query":"instagram","lang":"en","country":"us","next_cursor":null,"apps":[{"app_id":"com.instagram.android","url":"https://play.google.com/store/apps/details?id=com.instagram.android"},{"app_id":"com.instagram.airwave","url":"https://play.google.com/store/apps/details?id=com.instagram.airwave","title":"Instagram","icon":"https://play-lh.googleusercontent.com/bh871pyeIpMnJxGYKmTJCm-5VwIYrPUYhHQcCky0B-DpsMoPCWVSDKz0Ic7MLsGuLmS4F_-iE6BilqsUM2DloA","screenshots":["https://play-lh.googleusercontent.com/W2LPLG_VU3kMNbzA6r3Fwm2FwJ3v-GTVgMYl2I1-riz_37t-2eI-aajo2bpMJEwoVFuw0rqX_9EXzIe6eJy6fw","https://play-lh.googleusercontent.com/-tyrJPPz_uoGEnAVAXNUm22cykstJlAeMw0lqd0YI1t21UC-vBR7k-4EobJYplsu_z7L1qbO_Df3-a7yR1G0Ag","… 7 more"],"score":3.9433963,"score_text":"3.9","genre":"Social","price_value":0,"currency":"USD","description":"Instagram, now on your TV.<br><br>Watch the creators and content you love on Instagram, now on the biggest screen in your home. Enjoy Reels,…","developer":"Instagram","installs":"5,000,000+","header_image":"https://play-lh.googleusercontent.com/qUNnj9KTFkrvwZn4Qq_d03MGv0aZeHbXUchVv8wN5M78zSIKQW6LvXBjDEg6hovcd3-33s8UrzH7jJReTnPSl2Q","content_rating":"Teen","in_app_purchases":null},"… 21 more"],"cached":false,"credits_used":2}},"text/csv":{"schema":{"type":"string"}},"application/x-ndjson":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"404":{"$ref":"#/components/responses/E404"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}}}},"/google-play/v1/similar":{"get":{"operationId":"googlePlaySimilar","summary":"Google Play similar apps","description":"The apps Google Play lists as similar to an app, about 50 per page: app id, title, developer, icon, rating, and on the first page also description, genre, price, installs, content rating, in-app purchase range and screenshots (later pages carry a short summary and the developer link). Pass `next_cursor` back as `cursor`; null on the last page.\n\nEvery response includes `credits_used`: the credits this call cost.\n\nPrice: 5 credits per successful call. Docs: https://api.sh/docs/google-play-similar","tags":["Google Play"],"x-credits":5,"parameters":[{"name":"app_id","in":"query","required":true,"description":"The app's package name, as in play.google.com/store/apps/details?id=<app_id>.","schema":{"type":"string"},"example":"com.spotify.music"},{"name":"lang","in":"query","required":false,"description":"Language of the texts (default en).","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"Two-letter store country (default us).","schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"description":"Pass `next_cursor` from the previous response.","schema":{"type":"string"}},{"$ref":"#/components/parameters/raw"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/fresh"},{"$ref":"#/components/parameters/output"},{"$ref":"#/components/parameters/records"}],"responses":{"200":{"description":"The data as JSON (or CSV / NDJSON with `output`).","headers":{"x-request-id":{"$ref":"#/components/headers/x-request-id"},"x-credits-used":{"$ref":"#/components/headers/x-credits-used"},"x-credits-remaining":{"$ref":"#/components/headers/x-credits-remaining"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"example":{"app_id":"com.spotify.music","lang":"en","country":"us","count":50,"next_cursor":"IABixQFKPwo9CDUQv_iPsQoQ_4CuJBCAvYPrCBDFkM-HDRC52OKFCRD8zL2qDBDKsIy8ARCqo7ahAhDxnNamCRCtoMfhAVAyaixOSTM1MGpCak8yWUkxQzgyeDlpeTZzb01OUmdhOGpN…","apps":[{"app_id":"com.pinterest","url":"https://play.google.com/store/apps/details?id=com.pinterest","title":"Pinterest","developer":"Pinterest","developer_url":null,"summary":null,"description":"Pinterest is a place of endless possibilities. You can:<br>- Discover everyday inspiration<br>- Shop styles you love<br>- Try and learn some…","icon":"https://play-lh.googleusercontent.com/VExMwhu9Fe5kz72YnPWP6mHrNA5WfgZ-PJMnBnQmXFpLncTAOaaHtK4b8w7b2xxGxtqycDatYslVyNSLucl9QA","screenshots":["https://play-lh.googleusercontent.com/4GifaX9xZ_9yNbntIMQCraKT09fpsiil6740fNTS4SZp06x3FHunpvtWo_XEORaNCmeNNWBiM13_2rwOxuzQfg","https://play-lh.googleusercontent.com/Em5uQz3T_lNNRgKIQCHw61tPCb7AwwR5IHLeXgiFfrrLfiDX_odK6oeXY3JTjCVQ24nKeLRKy2ddYtc45jpoOg","… 6 more"],"score":4.237974,"score_text":"4.2","genre":"Lifestyle","price_value":0,"currency":"USD","installs":"1,000,000,000+","content_rating":"Teen","in_app_purchases":"$5.88 - $329.41 per item"},{"app_id":"com.snapchat.android","url":"https://play.google.com/store/apps/details?id=com.snapchat.android","title":"Snapchat","developer":"Snap Inc","developer_url":null,"summary":null,"description":"Snapchat is a fast and fun way to share the moment with your friends and family 👻<br><br>SNAP <br>• Snapchat opens right to the Camera — jus…","icon":"https://play-lh.googleusercontent.com/nOJWJoDAzuRSHmlFfpzHXAj8UbTJwk_JGYf0uAPTKPtiiIX_2Y7r5ATO1ZtxHRqaFTqfIDZ40PnBK4hukeJh","screenshots":["https://play-lh.googleusercontent.com/jAybrh9MrHfl0un4RurpPJ5BFz3jteLcBucau9QussxStN-GkaKCmaWCB9hKY76JAkZamQNG9e9vQ81cWxPwrQE","https://play-lh.googleusercontent.com/seBrLKVc3wCR_j2ln7iVmxBrz0ILWkRKKOq946XbG84867SmjB_PkakHejoKpX75O1DE3BV1uki0GY7aDT9shm0","… 9 more"],"score":4.175408,"score_text":"4.2","genre":"Communication","price_value":0,"currency":"USD","installs":"1,000,000,000+","content_rating":"Teen","in_app_purchases":"$0.49 - $399.99 per item"},"… 48 more"],"cached":false,"credits_used":5}},"text/csv":{"schema":{"type":"string"}},"application/x-ndjson":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"404":{"$ref":"#/components/responses/E404"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}}}},"/google-play/v1/suggest":{"get":{"operationId":"googlePlaySuggest","summary":"Google Play search suggestions","description":"The store's search suggestions for what was typed, in order, with the search link of each.\n\nEvery response includes `credits_used`: the credits this call cost.\n\nPrice: 1 credit per successful call. Docs: https://api.sh/docs/google-play-suggest","tags":["Google Play"],"x-credits":1,"parameters":[{"name":"q","in":"query","required":true,"description":"The text typed so far.","schema":{"type":"string"},"example":"spoti"},{"name":"lang","in":"query","required":false,"description":"Language (default en).","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"Two-letter country (default us).","schema":{"type":"string"}},{"$ref":"#/components/parameters/raw"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/fresh"},{"$ref":"#/components/parameters/output"},{"$ref":"#/components/parameters/records"}],"responses":{"200":{"description":"The data as JSON (or CSV / NDJSON with `output`).","headers":{"x-request-id":{"$ref":"#/components/headers/x-request-id"},"x-credits-used":{"$ref":"#/components/headers/x-credits-used"},"x-credits-remaining":{"$ref":"#/components/headers/x-credits-remaining"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"example":{"q":"spoti","lang":"en","country":"us","count":5,"suggestions":["spotify","spotify for artists","… 3 more"],"items":[{"term":"spotify","url":"https://play.google.com/store/search?q=spotify&c=apps"},{"term":"spotify for artists","url":"https://play.google.com/store/search?q=spotify+for+artists&c=apps"},"… 3 more"],"cached":false,"credits_used":1}},"text/csv":{"schema":{"type":"string"}},"application/x-ndjson":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"404":{"$ref":"#/components/responses/E404"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}}}}},"components":{"securitySchemes":{"apiKey":{"type":"apiKey","in":"header","name":"x-api-key","description":"Create keys at https://app.api.sh/keys. Authorization: Bearer <key> also works."}},"parameters":{"raw":{"name":"raw","in":"query","required":false,"description":"0 leaves out the bulky `raw` source blocks (often 10-30x smaller).","schema":{"type":"string","enum":["0","1"]}},"fields":{"name":"fields","in":"query","required":false,"description":"Comma-separated fields to return, e.g. `posts.id,posts.title`. Call metadata is always included.","schema":{"type":"string"}},"fresh":{"name":"fresh","in":"query","required":false,"description":"1 skips the 24-hour cache and fetches live.","schema":{"type":"string","enum":["1"]}},"output":{"name":"output","in":"query","required":false,"description":"csv or ndjson returns the response's records (its main list, or the object as one row) as CSV or NDJSON instead of JSON.","schema":{"type":"string","enum":["json","csv","ndjson"]}},"records":{"name":"records","in":"query","required":false,"description":"With output=csv|ndjson: the top-level list to turn into rows (e.g. `reviews`), or `.` for the whole object as one row.","schema":{"type":"string"}}},"schemas":{"Error":{"type":"object","properties":{"success":{"type":"boolean","const":false},"error":{"type":"string"}},"required":["success","error"]}},"responses":{"E400":{"description":"A parameter is missing or invalid. Not charged (unless the call ran and the source rejected the value; credits_used says).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"E401":{"description":"Missing, invalid, revoked or expired API key. Not charged. See https://api.sh/docs/errors#401","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"E402":{"description":"Not enough credits, a spend limit you set was reached (`spend_limit`), or the key's monthly credit cap was reached (`key_cap`). Not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"E404":{"description":"Not found, or not public. A lookup that ran costs the endpoint's price (credits_used says); an unknown route is free.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"E502":{"description":"The source site failed this time; retry. Not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"E503":{"description":"Endpoint paused or temporarily unavailable; may include retry-after. Not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"headers":{"x-request-id":{"description":"The call's id (logs, re-fetch with /v1/results/{id}).","schema":{"type":"string","format":"uuid"}},"x-credits-used":{"description":"Credits charged for this call.","schema":{"type":"integer"}},"x-credits-remaining":{"description":"Balance after the call.","schema":{"type":"integer"}}}},"externalDocs":{"url":"https://api.sh/docs"}}