# Google Play 主页或对象详情 API (google_play.profile)

- Canonical page: https://everyinfra.com/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 | Android 应用包名，例如 com.example.app，即 Play 商店链接 ?id= 后的值；不是 Apple App Store 的数字 ID。不要把完整 Play URL 填进 app_id，该值会作为包名直接使用。 |
| country | not declared | no | not declared | Google Play 店面国家/地区，建议小写代码，默认 us；search、profile 用它决定查哪个国家的店面，不是用户手机地区或应用开发者国籍。reviews 里它不改变返回哪些评价：评价只随 language 变，同一 language 下 us、gb 返回的评价相同（10-25 实测）。要按国家比较评价，请换 language，不要只换 country。 |
| language | not declared | no | not declared | Play 商店内容/评论查询语言，默认 en；例如 en 或 zh。它不自动更换 country，也不保证所有返回评论都是该语言的原文。 |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| app_id | 应用包名（如 com.example.app），Google Play 的唯一标识。 |
| url | 该记录在原平台上的可访问链接。 |
| name | 名称。用于账号/商品/商家类能力，指该对象本身的名字。 |
| summary | 应用一句话简介。 |
| description | 简介或描述，通常比 text 短。 |
| developer | 开发者名称。 |
| developer_email | 开发者联系邮箱（商店页公开信息）。 |
| developer_website | 开发者网站。 |
| score | 应用评分，5 分制。 |
| rating_count | 参与评分的人数。null 表示不公开，不等于 0。 |
| review_count | 评价条数，用于商品/商家类能力。null 表示不公开，不等于 0。 |
| installs | 安装量展示值（如 1,000,000+），是区间下限不是精确值。 |
| min_installs | 安装量区间下限的数值形式。 |
| price | 价格数值，不含货币符号；币种见 currency。 |
| is_free | 是否免费下载。 |
| currency | 价格币种代码（如 CNY、USD）。price 存在但 currency 为 null 时不要假定币种。 |
| category | 分类名称，取值为原平台的分类体系，未做跨平台归一。 |
| content_rating | 内容分级。 |
| contains_ads | 是否含广告。 |
| offers_iap | 是否含内购。 |
| version | 版本号。 |
| released | 首次发布日期。 |
| updated_at | 最近更新时间。长期不更新是维护风险信号。 |
| android_version | 要求的最低 Android 版本。 |
| icon_url | 应用图标。 |
| header_image_url | 商店页头图。 |
| privacy_policy | 隐私政策链接。 |
| platform | 数据来源平台标识，与请求里的 platform 一致（如 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