App Store主页或对象详情 API
POST
接口健康状态
- 24h 健康值
- 正常
- 24h 平均耗时
- —
- 最近检查时间
- 2026年9月27日 00:34（北京时间）
- 健康 / 正常
- 可用
- 少量可用
- 基本不可用
健康 API正常
24 小时趋势
30 天趋势
健康值怎么算
- 健康值 = 返回了数据的调用占比（百分比）。空结果、失败和结果未知都不算返回数据。
- 档位：≥90% 健康、≥70% 可用、≥40% 少量可用，更低是基本不可用。
- 一个时段（24 小时、每小时、每天）调用满 50 次才计算健康值；不足的时段显示为正常——少量调用里的偶发失败不代表接口不可用。
- 调用包括客户的真实调用和我们每天的探测调用；请求本身的错误（参数不对、余额不足）不计入。
- 平均耗时只算正常返回的调用：同步取响应时间，异步取受理到完成。
逐时段数据
| 时间（北京时间） | 状态 | 健康值 | 平均耗时 |
|---|---|---|---|
| 2026-09-27 00:00 - 00:59 | 正常 | — | — |
| 2026-09-26 23:00 - 23:59 | 正常 | — | — |
| 2026-09-26 22:00 - 22:59 | 正常 | — | — |
| 2026-09-26 21:00 - 21:59 | 正常 | — | — |
| 2026-09-26 20:00 - 20:59 | 正常 | — | — |
| 2026-09-26 19:00 - 19:59 | 正常 | — | — |
| 2026-09-26 18:00 - 18:59 | 正常 | — | — |
| 2026-09-26 17:00 - 17:59 | 正常 | — | — |
| 2026-09-26 16:00 - 16:59 | 正常 | — | — |
| 2026-09-26 15:00 - 15:59 | 正常 | — | — |
| 2026-09-26 14:00 - 14:59 | 正常 | — | — |
| 2026-09-26 13:00 - 13:59 | 正常 | — | — |
| 2026-09-26 12:00 - 12:59 | 正常 | — | — |
| 2026-09-26 11:00 - 11:59 | 正常 | — | — |
| 2026-09-26 10:00 - 10:59 | 正常 | — | — |
| 2026-09-26 09:00 - 09:59 | 正常 | — | — |
| 2026-09-26 08:00 - 08:59 | 正常 | — | — |
| 2026-09-26 07:00 - 07:59 | 正常 | — | — |
| 2026-09-26 06:00 - 06:59 | 正常 | — | — |
| 2026-09-26 05:00 - 05:59 | 正常 | — | — |
| 2026-09-26 04:00 - 04:59 | 正常 | — | — |
| 2026-09-26 03:00 - 03:59 | 正常 | — | — |
| 2026-09-26 02:00 - 02:59 | 正常 | — | — |
| 2026-09-26 01:00 - 01:59 | 正常 | — | — |
| 2026-09-26 | 正常 | — | — |
| 2026-09-25 | 正常 | — | — |
| 2026-09-24 | 正常 | — | — |
| 2026-09-23 | 正常 | — | — |
| 2026-09-22 | 正常 | — | — |
| 2026-09-21 | 正常 | — | — |
| 2026-09-20 | 正常 | — | — |
| 2026-09-19 | 正常 | — | — |
| 2026-09-18 | 正常 | — | — |
| 2026-09-17 | 正常 | — | — |
| 2026-09-16 | 正常 | — | — |
| 2026-09-15 | 正常 | — | — |
| 2026-09-14 | 正常 | — | — |
| 2026-09-13 | 正常 | — | — |
| 2026-09-12 | 正常 | — | — |
| 2026-09-11 | 正常 | — | — |
| 2026-09-10 | 正常 | — | — |
| 2026-09-09 | 正常 | — | — |
| 2026-09-08 | 正常 | — | — |
| 2026-09-07 | 正常 | — | — |
| 2026-09-06 | 正常 | — | — |
| 2026-09-05 | 正常 | — | — |
| 2026-09-04 | 正常 | — | — |
| 2026-09-03 | 正常 | — | — |
| 2026-09-02 | 正常 | — | — |
| 2026-09-01 | 正常 | — | — |
| 2026-08-31 | 正常 | — | — |
| 2026-08-30 | 正常 | — | — |
| 2026-08-29 | 正常 | — | — |
| 2026-08-28 | 正常 | — | — |
主页或对象详情：返回单个对象；主要字段 app_id、name、url、bundle_id、developer、developer_id。
单价 $1.39 / 千次（每次 $0.001389），失败与空结果不扣费。 同步返回；慢任务可在请求体加 "mode": "async"，先拿 job_id 再轮询。
请求参数
| 参数名 | 位置 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|---|
Authorization | header | string | 是 | - | Bearer 加你的 API Key。在控制台创建；不要放进网址或代码仓库。 |
platform | body | string | 是 | app_store | 平台标识，固定值。 |
action | body | string | 是 | profile | 能力标识，固定值。 |
app_id | body.params | 未声明 | 是 | - | Apple 的数字应用 ID，例如应用链接中 id 后的数字；也可将完整 App Store 应用链接放入此参数，系统提取数字 ID。不是 com.example.app 形式的 Bundle ID。 |
country | body.params | 未声明 | 否 | - | App Store 店面国家/地区，使用小写代码，例如 us、cn、jp，默认 us。详情与评论都按该店面查询；应用在其他店面可见不代表在当前店面同样上架。 |
代码示例
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"
}
}'[OpenAPI 定义 (JSON)]示例从环境变量 EVERYINFRA_API_KEY 读取 Key，复制出去的代码不含你的 Key。
响应示例
真实返回样例
2026年9月26日 16:56（北京时间）用上方代码示例的参数真实调用所得。results 与 count 是那次的真实返回，已隐去名字、账号、头像、主页链接、联系方式等个人信息；id、billing、quota 每次调用都不同，只给结构。
json
{
"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": { … },
"quota": { … }
}返回字段
业务数据在 results 里；下表是每条记录可能包含的字段，上游没有提供的值不会被补造。
| 字段 | 含义 |
|---|---|
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 | 保留平台原语义 |
languages | 保留平台原语义 |
screenshot_urls | 保留平台原语义 |
错误与计费
- 401
- 缺少 Key 或 Key 无效。先鉴权再校验参数，未鉴权的请求拿不到参数结构。
- 422
- 参数名或取值不对。错误信息会列出这项能力支持的参数、允许值和最接近的候选，按它改即可；发生在扣费之前。
- 402
- 余额不足，请先充值。
- 429
- 超过每分钟请求上限，按 Retry-After 等待后再试。
- 503
- 暂时无法完成。已预扣的费用按原账本退回；响应里的 billing 与 refund 写明实际结果，结果未知时会明确标出，不要直接重发。
- 200 空结果
- 请求完成但没有数据，不扣费（billing.reason = empty_result_refunded）。