# Google Play Details API (google_play.profile)

- Canonical page: https://everyinfra.com/en/google-play-api/profile
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "google_play", "action": "profile", "params": {...}}
- Price: $0.001389 per call ($1.39 per 1,000 requests); failed calls and empty results are not charged
- Returns: single object
- 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=profile

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| app_id | not declared | yes | not declared | The Android package name from the `?id=` value of a Play Store URL, such as `com.example.app`. It is not an Apple App Store numeric ID. Pass the package name, not the full Play URL. |
| 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`. |
| 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. |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| app_id | platform-native meaning |
| url | Link to the record on the platform. |
| name | Name of the object itself, for account, product and business capabilities. |
| summary | platform-native meaning |
| description | Summary or description, usually shorter than text. |
| developer | platform-native meaning |
| developer_email | platform-native meaning |
| developer_website | platform-native meaning |
| score | platform-native meaning |
| rating_count | Number of people who rated. null means not disclosed, not 0. |
| review_count | Number of reviews, for product and business capabilities. null means not disclosed, not 0. |
| installs | platform-native meaning |
| min_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. |
| category | Category name in the platform's own taxonomy, not normalized across platforms. |
| content_rating | platform-native meaning |
| contains_ads | platform-native meaning |
| offers_iap | platform-native meaning |
| version | platform-native meaning |
| released | platform-native meaning |
| updated_at | platform-native meaning |
| android_version | platform-native meaning |
| icon_url | platform-native meaning |
| header_image_url | platform-native meaning |
| privacy_policy | platform-native meaning |
| platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |
| screenshots | platform-native meaning |
| rating_histogram | platform-native meaning |

## 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": "profile",
  "params": {
    "app_id": "com.whatsapp"
  }
}'
```

```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": "profile",
        "params": {
            "app_id": "com.whatsapp",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

Real response to the example request above, captured 2026-09-26T08:56:04Z. `results` and `count` are real with personal information (names, handles, avatars, profile links, contact details) removed. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "google_play",
  "action": "profile",
  "results": {
    "app_id": "com.whatsapp",
    "url": "https://play.google.com/store/apps/details?id=com.whatsapp",
    "name": "WhatsApp Messenger",
    "summary": "Simple. Reliable. Private.",
    "description": "WhatsApp from Meta is a FREE messaging and video calling app. It’s used by over 2B people in more than 180 countries. It’s simple, reliable, and private, so you can easily keep in touch with your friends and family. WhatsApp works across mobile and desktop even on slow connection…",
    "developer": "WhatsApp LLC",
    "developer_email": "•••",
    "developer_website": "http://www.whatsapp.com/",
    "score": 4.6162252,
    "rating_count": 244448648,
    "review_count": 1952559,
    "installs": "10,000,000,000+",
    "min_installs": 10000000000,
    "price": 0,
    "is_free": true,
    "currency": "USD",
    "category": "Communication",
    "content_rating": "Everyone",
    "contains_ads": false,
    "offers_iap": true,
    "version": "VARY",
    "released": "Oct 18, 2010",
    "updated_at": "2026-09-19T00:49:04.000Z",
    "android_version": "Varies with device",
    "icon_url": "https://play-lh.googleusercontent.com/Gqxk4T0uZsDwFp07DE-508hkyvcNmgFuRwPiwTEfF7D7OzGv1FdHDzEyMxNsSBZLOJlGpe3ULvVM2RgrRAlBqA",
    "header_image_url": "https://play-lh.googleusercontent.com/eLX_xvno2Kq_zvpkkP8yPBRfo2TEQSrv7m7WrQ6xloPsDRJ85XQ28kGYuoR-_EBWh2Uoq2GMlDvlBEIxHRyhuSg",
    "privacy_policy": "https://www.whatsapp.com/legal/privacy-policy",
    "platform": "google_play",
    "screenshots": [
      "https://play-lh.googleusercontent.com/GQF4h3VL-kklOrVS_f1QRAJJZa2zQyVNcFbKdOIkvI_Pcu1op0Sy3uiryiTxpdcCDs7vEDA9eq0eWbxo0fx_wc8",
      "https://play-lh.googleusercontent.com/Q042rTbs53V_jW_c5fMqnNLCf-FBKiO2KiFKJJACa65oMCkaxqDSFKPQ7TH8nYetS-js-fMV7ptXSsF-aCkvcw",
      "https://play-lh.googleusercontent.com/EefxorXU8H0etXPHJsq4Nao8Npj7FqVT_h5rumnUS9KvIN7i-3WRotwduyEGi1Zg33BFHcuYRjQ0i01I3zJS"
    ],
    "rating_histogram": {
      "1": 10906306,
      "2": 3474926,
      "3": 8938533,
      "4": 21886032,
      "5": 199242772
    }
  },
  "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