# Top Free Games Chart – Google Play

> Top Free 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 ranked list of top free games on the Google Play Store, optionally filtered by category, region, and language.

## Facts

- Endpoint: GET https://agents.openwebninja.com/play-store-apps/top-free-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-free-games-chart-google-play-1b0acac8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_N2X0VmOmWZDe02JK00qBo

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-free-games-chart-google-play-1b0acac8
```

Example prompt: What are the top 50 free games on the Google Play Store in the US right now — can you pull the full chart including ratings and download counts?

## When to prefer this

Use this endpoint when you need the current ranked chart of top free games on Google Play, especially when you need category-level filtering, regional localization, or rich metadata (ratings, installs, icons, trailers) for each game. Prefer this over a general app search when you specifically want chart-ranked results for games rather than arbitrary search queries.

## Known failure modes

- Invalid or unsupported category string returns an empty data array or error
- Invalid region or language code may default to US/EN or return an error
- Limit above 200 is capped or rejected; limits 101–200 are billed as 2 requests
- Service may return stale chart data if Google Play has not refreshed rankings recently
- Network timeout or upstream Google Play unavailability results in a 5xx error

## How this service works

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

## Output

Returns an array of ranked game entries, each containing the app's chart position, name, package ID, developer, Google Play URL, average rating, number of ratings and reviews, approximate install count, icon URL, screenshot URLs, trailer URL, category, whether it contains ads, and price info (typically 0 for free games).

## 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-free-games-chart-google-play-1b0acac8/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)