{"uid":"cap_mzlCkAsNzJpPXZPB7Q9Oa","slug":"agents-openwebninja-com-top-grossing-games-chart-google-play-06b38a08","name":"Top Grossing Games Chart (Google Play)","description":"Top grossing games chart. Supports getting the chart for specific Google Play categories.","url":"https://agents.openwebninja.com/play-store-apps/top-grossing-games?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"type":"integer","default":50,"maximum":200,"minimum":1,"description":"Limit the number of results.  \n\n  **Note:** requests with a limit value between 101-200 will be charged double (2 requests)."},"region":{"type":"integer","default":"US","description":"The country code of country/region to use, specified as a 2-letter country code - see ISO 3166-1 alpha-2."},"category":{"type":"string","description":"Get the chart in a specific Google Play category (e.g. SOCIAL)."},"language":{"type":"string","default":"EN","description":"The language to use, specified as a 2-letter language code - see ISO 639-1 alpha-2."}}},"responseSchema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","required":["app_id","app_name","app_developer","app_page_link"],"properties":{"price":{"type":"number","nullable":true,"description":"Listed price in the regional currency (0 for free apps)."},"app_id":{"type":"string","description":"Google Play package id of the app."},"photos":{"type":"array","items":{"type":"string","description":"Screenshot URL."},"nullable":true,"description":"Screenshot image URLs from the Play Store listing."},"rating":{"type":"number","nullable":true,"description":"Average user rating (0–5)."},"is_paid":{"type":"boolean","nullable":true,"description":"Whether the app is paid (true) or free (false)."},"trailer":{"type":"string","nullable":true,"description":"URL of the app's video trailer, when available."},"app_icon":{"type":"string","nullable":true,"description":"URL of the app's icon image."},"app_name":{"type":"string","description":"Display name of the app."},"chart_rank":{"type":"integer","nullable":true,"description":"Position of the app in the chart (1-based)."},"chart_label":{"type":"string","nullable":true,"description":"Label of the chart the app is part of (e.g. \"top grossing productivity\")."},"num_ratings":{"type":"integer","nullable":true,"description":"Total number of user ratings."},"num_reviews":{"type":"integer","nullable":true,"description":"Total number of user reviews."},"app_category":{"type":"string","nullable":true,"description":"Human-readable Google Play category of the app."},"contains_ads":{"type":"boolean","nullable":true,"description":"Whether the app contains ads."},"app_developer":{"type":"string","description":"Developer / publisher name."},"app_page_link":{"type":"string","description":"Canonical Google Play URL of the app."},"num_downloads":{"type":"string","nullable":true,"description":"Approximate install count as displayed on the Play Store (e.g. \"1,000,000,000+\")."},"price_currency":{"type":"string","nullable":true,"description":"ISO 4217 currency code of `price`. Null for free apps."},"app_category_id":{"type":"string","nullable":true,"description":"Google Play category id (uppercase machine code, e.g. PRODUCTIVITY, GAME_ADVENTURE)."},"app_description":{"type":"string","nullable":true,"description":"Full app description text from the Play Store listing."},"app_permissions":{"type":"array","items":{"type":"string","description":"Permission description."},"nullable":true,"description":"Android permissions requested by the app."},"current_version":{"type":"string","nullable":true,"description":"Current version string of the app, when surfaced by the Play Store."},"app_content_rating":{"type":"string","nullable":true,"description":"Content rating label (e.g. Everyone, Teen, Mature)."},"reviews_per_rating":{"type":"object","nullable":true,"properties":{"1":{"type":"integer","description":"Number of 1-star ratings."},"2":{"type":"integer","description":"Number of 2-star ratings."},"3":{"type":"integer","description":"Number of 3-star ratings."},"4":{"type":"integer","description":"Number of 4-star ratings."},"5":{"type":"integer","description":"Number of 5-star ratings."}},"description":"Count of ratings per star bucket (keys '1'..'5')."},"security_practices":{"type":"array","items":{"type":"string","description":"Security practice."},"nullable":true,"description":"Data Safety section: security practices declared by the developer."},"app_developer_email":{"type":"string","nullable":true,"description":"Developer's contact email."},"max_android_version":{"type":"string","nullable":true,"description":"Maximum Android version the app supports, when declared."},"min_android_version":{"type":"string","nullable":true,"description":"Minimum Android version the app supports."},"num_downloads_exact":{"type":"integer","nullable":true,"description":"Exact install count when available."},"privacy_policy_link":{"type":"string","nullable":true,"description":"URL of the developer's privacy policy."},"app_developer_website":{"type":"string","nullable":true,"description":"Developer's website URL."},"max_android_api_level":{"type":"integer","nullable":true,"description":"Maximum Android API level the app supports, when declared."},"min_android_api_level":{"type":"integer","nullable":true,"description":"Minimum Android API level the app supports."},"app_updated_at_timestamp":{"type":"integer","nullable":true,"description":"Unix timestamp (seconds) of the last app update on the Play Store."},"current_version_whatsnew":{"type":"string","nullable":true,"description":"\"What's new\" notes for the current version."},"data_shared_by_app_and_why":{"type":"object","nullable":true,"description":"Data Safety section: data the app shares, grouped by data category. Keys are category names; values map field name to comma-separated purposes.","additionalProperties":true},"app_updated_at_datetime_utc":{"type":"string","nullable":true,"description":"ISO 8601 UTC datetime of the last app update."},"data_collected_by_app_and_why":{"type":"object","nullable":true,"description":"Data Safety section: data the app collects, grouped by data category. Keys are category names; values map field name to comma-separated purposes.","additionalProperties":true},"app_first_released_at_timestamp":{"type":"integer","nullable":true,"description":"Unix timestamp (seconds) of the first release of the app."},"app_first_released_at_datetime_utc":{"type":"string","nullable":true,"description":"ISO 8601 UTC datetime of the first release of the app."},"current_version_released_at_timestamp":{"type":"integer","nullable":true,"description":"Unix timestamp (seconds) of the current version release, when surfaced."},"current_version_released_at_datetime_utc":{"type":"string","nullable":true,"description":"ISO 8601 UTC datetime of the current version release, when surfaced."}}},"description":"Array of top-grossing games for the requested country/category."},"status":{"type":"string","description":"The status of the response"},"request_id":{"type":"string","description":"A unique identifier for the request"}}},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"unknown","displayCostAsset":"USD","priceDynamic":true,"priceHint":null,"priceStatus":"unprobed","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"unknown","summary":"price unknown","primary":{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_YavJ-Yl6hnTfpnU3pZ1Ip","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"unknown","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.openwebninja.com","brandSlug":"agents-openwebninja-com-x402","brandBaseUrl":"https://agents.openwebninja.com","brandDocsUrl":null,"whatItDoes":"Returns the top-grossing games chart from the Google Play Store, optionally filtered by category, region, and language.","exampleAgentPrompt":"Can you pull up the top 50 grossing games on Google Play in the US right now, filtered to the ROLE_PLAYING category?","exampleUseCases":[{"title":"Mobile gaming market research","prompt":"I'm doing competitive research — can you get me the top 100 highest-grossing Android games on the Google Play Store in the US right now, including their ratings and developer names?"},{"title":"Regional revenue chart analysis","prompt":"What are the top 50 grossing games on Google Play in Japan? I want to see the chart rankings, prices, and download counts so I can understand what's performing well there."},{"title":"Category-specific chart lookup","prompt":"Can you pull the top 25 grossing STRATEGY games on Google Play for the UK, with ratings and whether they contain ads?"}],"resultDescription":"Returns an array of game listings each containing: chart rank, app name, app ID, developer, Google Play URL, price, currency, average rating, number of ratings and reviews, approximate download count, app icon URL, screenshot URLs, trailer URL, category, whether the app is paid, and whether it contains ads.","failureModes":["Invalid country code returns empty results or error","Unsupported category string returns empty chart or error","Limit above 200 is rejected; limits 101-200 count as 2 requests","Rate limiting or payment failure returns 402","No results if the category has fewer games than the requested limit"],"whenToPreferThis":"Use this endpoint when you need real-time Google Play Store top-grossing games chart data, especially when filtering by specific game categories, regions, or languages. Prefer this over general app search endpoints when the goal is chart/ranking data rather than searching for specific apps by name.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:36:40.845Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-top-grossing-games-chart-google-play-06b38a08"}