# App Store 主页或对象详情 API (app_store.profile)

- Canonical page: https://everyinfra.com/app-store-api/profile
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "app_store", "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=app_store&action=profile

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| app_id | not declared | yes | not declared | Apple 的数字应用 ID，例如应用链接中 id 后的数字；也可将完整 App Store 应用链接放入此参数，系统提取数字 ID。不是 com.example.app 形式的 Bundle ID。 |
| country | not declared | no | not declared | App Store 店面国家/地区，使用小写代码，例如 us、cn、jp，默认 us。详情与评论都按该店面查询；应用在其他店面可见不代表在当前店面同样上架。 |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| app_id | App Store 数字 ID。 |
| name | 名称。用于账号/商品/商家类能力，指该对象本身的名字。 |
| url | 该记录在原平台上的可访问链接。 |
| bundle_id | 应用包名（com.xxx.yyy），开发侧唯一标识。 |
| developer | 开发者名称。 |
| developer_id | 开发者 ID。 |
| developer_url | 开发者页链接。 |
| description | 简介或描述，通常比 text 短。 |
| release_notes | 更新说明。 |
| version | 版本号。 |
| price | 价格数值，不含货币符号；币种见 currency。 |
| currency | 价格币种代码（如 CNY、USD）。price 存在但 currency 为 null 时不要假定币种。 |
| formatted_price | 价格展示文本（如「免费」或带币种符号的金额）。 |
| rating | 评分。**分制随平台而异**，同一行的 `rating_scale` 给出该平台满分 (多数是 5，Booking/豆瓣/爱奇艺/NAVER 是 10)。跨平台比较前必须先按 rating_scale 换算。直接比数字会得出反的结论。 |
| rating_scale | 上一列 `rating` 的满分。5 表示五星制、10 表示十分制。只在该行有 rating 时出现。 |
| rating_count | 参与评分的人数。null 表示不公开，不等于 0。 |
| current_version_rating | 当前版本的评分。大改版后看它比总评分更准。 |
| current_version_rating_count | 当前版本的评分人数。 |
| content_rating | 年龄分级。 |
| category | 分类名称，取值为原平台的分类体系，未做跨平台归一。 |
| icon_url | 应用图标。 |
| min_os | 最低系统版本要求。 |
| file_size_bytes | 安装包大小，字节。 |
| released_at | 首次上架时间。 |
| updated_at | 最近更新时间。 |
| platform | 数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。 |
| genres | 应用所属的分类，按 App Store 原文；没有时不出现这个字段。 |
| languages | 应用支持的语言列表，按 App Store 原文；没有时不出现这个字段。 |
| screenshot_urls | 应用截图链接数组，按商店展示顺序；没有时不出现这个字段。 |

## 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": "app_store",
  "action": "profile",
  "params": {
    "app_id": "389801252"
  }
}'
```

```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": "app_store",
        "action": "profile",
        "params": {
            "app_id": "389801252",
        },
    },
    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": "app_store",
  "action": "profile",
  "results": {
    "app_id": 389801252,
    "name": "Instagram",
    "url": "https://apps.apple.com/us/app/instagram/id389801252?uo=4",
    "bundle_id": "com.burbn.instagram",
    "developer": "Instagram, Inc.",
    "developer_url": "https://apps.apple.com/us/developer/instagram-inc/id389801255?uo=4",
    "description": "Little moments lead to big friendships. Share yours on Instagram. \n— From Meta\n\nConnect with friends, find other fans, and see what people around you are up to and into. Explore your interests and post what's going on, from your daily moments to life's highlights.\n\nShare what you…",
    "release_notes": "Performance optimizations and stability improvements for a smoother, more reliable experience.",
    "version": "448.0.0",
    "price": 0,
    "currency": "USD",
    "formatted_price": "Free",
    "rating": 4.69,
    "rating_count": 29523309,
    "current_version_rating_count": 29523309,
    "content_rating": "12+",
    "category": "Photo & Video",
    "icon_url": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/f5/7f/2c/f57f2c00-2dff-4704-501b-ab6849c6277d/Prod-0-0-1x_U007epad-0-1-0-sRGB-85-220.png/512x512bb.jpg",
    "min_os": "16.3",
    "file_size_bytes": 611172352,
    "released_at": "2010-10-06T08:12:41+00:00",
    "updated_at": "2026-09-21T15:59:55+00:00",
    "platform": "app_store",
    "genres": [
      "Photo & Video",
      "Social Networking"
    ],
    "languages": [
      "BN",
      "HR",
      "CS"
    ],
    "screenshot_urls": [
      "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/50/e2/8b/50e28b44-daa5-7101-6fb6-2d0e10fc72f3/1_iOS_5.5.jpg/392x696bb.jpg",
      "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/4d/a5/33/4da53369-3dce-b9b4-2a0c-1c6957dd40c4/1_iOS_5.5.jpg/392x696bb.jpg",
      "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/10/38/e1/1038e1c7-751f-c4ea-39b9-d9f4d08fc08d/2_iOS_5.5.jpg/392x696bb.jpg"
    ],
    "rating_scale": 5
  },
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## Also

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