App Store 主页或对象详情 API

POST

接口健康状态

24h 健康值: 正常

健康 / 正常
可用
少量可用
基本不可用

24 小时趋势

30 天趋势

主页或对象详情：返回单个对象；主要字段 app_id、name、url、bundle_id、developer、developer_id。

请求发到 POST https://api.everyinfra.com/api/v1/social，platform 填 app_store，action 填 profile。单价 $1.39 / 千次（每次 $0.001389），失败和空结果都不收费。同步返回；慢任务可在请求体加 "mode": "async"，先拿 job_id 再轮询。

AI 提示词

请帮我用 EveryInfra 的「App Store 主页或对象详情」接口（app_store/profile）写一个数据采集脚本。

接口约定：
- 请求：POST https://api.everyinfra.com/api/v1/social，请求头 Authorization: Bearer <API Key>；Key 从环境变量 EVERYINFRA_API_KEY 读取，不要写进代码。
- 请求体里 platform 填 app_store，action 填 profile，参数放在 params 里。
- 必填参数：
  - app_id：Apple 的数字应用 ID，例如应用链接中 id 后的数字；也可将完整 App Store 应用链接放入此参数，系统提取数字 ID。不是 com.example.app 形式的 Bundle ID。
- 可选参数：
  - country：App Store 店面国家/地区，使用小写代码，例如 us、cn、jp，默认 us。详情与评论都按该店面查询；应用在其他店面可见不代表在当前店面同样上架。
- 返回一个对象，主要字段：app_id（App Store 数字 ID）、name、url、bundle_id（应用包名（com.xxx.yyy））、developer（开发者名称）、developer_id（开发者 ID）、developer_url（开发者页链接）、description、release_notes（更新说明）、version（版本号）、price、currency；一共 28 个字段，完整列表见 https://api.everyinfra.com/api/v1/social/catalog?platform=app_store。
- 示例请求体：
{
  "platform": "app_store",
  "action": "profile",
  "params": {
    "app_id": "389801252"
  }
}
- 计费：$1.39 / 千次；失败和空结果不扣费。
- 一次要采几十上百个时，在请求体加 "mode": "async"：先拿到 job_id，再轮询 GET https://api.everyinfra.com/api/v1/jobs/{job_id} 取结果。
- 返回 422 时，按错误信息里的候选参数和允许值修正；返回 429 或 503 时，按 Retry-After 等待后重试。

写代码前，先问清楚我要采哪些对象、一共多少个、需要哪些字段、结果存成什么格式，再把方案和大概花费讲给我确认。

请求参数

参数名	位置	类型	必填	默认值	说明
`Authorization`	header	`string`	是	-	Bearer 加你的 API Key。在控制台创建；不要放进网址或代码仓库。
`platform`	body	`string`	是	`app_store`	平台标识，固定值。
`action`	body	`string`	是	`profile`	能力标识，固定值。
`app_id`	body.params	`string`	是	-	Apple 的数字应用 ID，例如应用链接中 id 后的数字；也可将完整 App Store 应用链接放入此参数，系统提取数字 ID。不是 com.example.app 形式的 Bundle ID。
`country`	body.params	`string`	否	-	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。

响应示例

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": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "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`	应用所属的分类，按 App Store 原文；没有时不出现这个字段。
`languages`	应用支持的语言列表，按 App Store 原文；没有时不出现这个字段。
`screenshot_urls`	应用截图链接数组，按商店展示顺序；没有时不出现这个字段。

错误与计费

401: 缺少 Key 或 Key 无效。
402: 余额不足，先充值。
422: 参数名或取值不对，按错误信息给的候选改；不扣费。
429: 超过每分钟请求上限，按 Retry-After 等待后再试。
503: 暂时无法完成，预扣的费用退回；结果未知时先核对，不要直接重发。
200 空结果: 没有数据，不扣费。

错误码