# Google Play Games API (google_play.games)

- Canonical page: https://everyinfra.com/en/google-play-api/games
- Endpoint: POST /api/v1/social with {"platform": "google_play", "action": "games", "params": {...}}
- Price: $0.000556 per call ($0.56 per 1,000 requests); failed and empty results are not charged
- Returns: list, default 20, max 50 per call (larger values are capped)
- Mode: sync; add "mode": "async" for slow tasks

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=google_play&action=games

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| category | not declared | no | not declared | A game category for `games`, such as `GAME_PUZZLE` or `GAME_ACTION`; the short form `puzzle` or `action` works too. Use it instead of `chart` or `keyword`, not together with them. |
| chart | not declared | no | not declared | The game chart for `games`: `top_free` (the default when nothing else is given), `top_paid` or `top_grossing`. Use it instead of `category` or `keyword`, not together with them. |
| country | not declared | no | not declared | Selects the Google Play storefront country or region using a lowercase code such as us. The default is us. For search and profile it changes the storefront being queried, not the user's phone region or the developer's nationality. For reviews it does not change which reviews come back: reviews vary only with `language`, so us and gb return the same reviews for the same language. To compare reviews across markets, change `language`, not only `country`. |
| keyword | not declared | no | not declared | A search term for games, such as `chess`. Use it instead of `chart` or `category`, not together with them. |
| language | not declared | no | not declared | Selects the language used for Play Store content and review queries, such as en or zh. The default is en. It does not change country automatically or guarantee that every returned review was written in that language. |
| limit | integer (1–50) | no | 20 | The most rows to return in this call, an integer from 1 to 50. The default applies when you leave it out, and a call can return fewer rows. Larger values are accepted and capped at the maximum. |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| rank | platform-native meaning |
| app_id | platform-native meaning |
| name | Name of the object itself, for account, product and business capabilities. |
| url | Link to the record on the platform. |
| developer | platform-native meaning |
| category | Category name in the platform's own taxonomy, not normalized across platforms. |
| score | platform-native meaning |
| installs | platform-native meaning |
| price | Price as a number without a currency symbol; see currency. |
| is_free | Whether the app is free to download (keywords_for_app). |
| currency | Currency code of the price (for example CNY, USD). If price is present but currency is null, do not assume a currency. |
| icon_url | platform-native meaning |
| description | Summary or description, usually shorter than text. |
| platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |

## Example

```bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "google_play",
  "action": "games",
  "params": {}
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "google_play",
        "action": "games",
        "params": {},
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

No real sample for these example parameters yet: structure only, every value is a placeholder (…).

```text
{
  "id": "req_…",
  "platform": "google_play",
  "action": "games",
  "results": [
    {
      "rank": …,
      "app_id": …,
      "name": …,
      "url": …,
      "developer": …,
      "category": …,
      "score": …,
      "installs": …,
      "price": …,
      "is_free": …,
      "currency": …,
      "icon_url": …,
      "description": …,
      "platform": …
    }
  ],
  "count": …,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=google_play
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md