# Top Grossing Games Chart (Google Play)

> Top Grossing Games Chart (Google Play) is a paid API for AI agents from agents.openwebninja.com, paid per call via MPP, price unknown, status unknown (last checked 2026-10-14).

Returns the top-grossing games chart from the Google Play Store, optionally filtered by category, region, and language.

## Facts

- Endpoint: GET https://agents.openwebninja.com/play-store-apps/top-grossing-games?utm_source=zero.xyz
- Price: price unknown
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Provider: agents.openwebninja.com
- Website: https://agents.openwebninja.com
- Canonical page: https://www.zero.xyz/c/agents-openwebninja-com-top-grossing-games-chart-google-play-06b38a08
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mzlCkAsNzJpPXZPB7Q9Oa

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agents-openwebninja-com-top-grossing-games-chart-google-play-06b38a08
```

Example prompt: Can you pull up the top 50 grossing games on Google Play in the US right now, filtered to the ROLE_PLAYING category?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Top grossing games chart. Supports getting the chart for specific Google Play categories.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-openwebninja-com-top-grossing-games-chart-google-play-06b38a08/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.openwebninja.com](https://www.zero.xyz/host/agents.openwebninja.com/llms.txt)
