App Store 关键词搜索 API

POST

接口健康状态

24h 健康值: 12%
24h 平均耗时: 16.23 s

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

基本不可用

24 小时趋势

30 天趋势

关键词搜索：返回列表，默认 20 条、单次最多 200 条；主要字段 app_id、name、url、bundle_id、developer、developer_id。

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

AI 提示词

请帮我用 EveryInfra 的「App Store 关键词搜索」接口（app_store/search）写一个数据采集脚本。

接口约定：
- 请求：POST https://api.everyinfra.com/api/v1/social，请求头 Authorization: Bearer <API Key>；Key 从环境变量 EVERYINFRA_API_KEY 读取，不要写进代码。
- 请求体里 platform 填 app_store，action 填 search，参数放在 params 里。
- 必填参数：
  - keyword：App Store 应用搜索词，例如 habit tracker 或应用名称；不是 Bundle ID。搜索结果中的 app_id 可继续用于应用详情和评论。
- 可选参数：
  - country：App Store 店面国家/地区，使用小写代码，例如 us、cn、jp，默认 us。详情与评论都按该店面查询；应用在其他店面可见不代表在当前店面同样上架。
  - limit：这次调用最多返回的条数，整数，1–200；不传按默认值，实际返回可能少于这个数。超过上限会在扣费前返回 422。（默认 20）
- 返回一组记录，每条记录的主要字段：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": "search",
  "params": {
    "keyword": "habit tracker"
  }
}
- 计费：$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`	是	`search`	能力标识，固定值。
`keyword`	body.params	`string`	是	-	App Store 应用搜索词，例如 habit tracker 或应用名称；不是 Bundle ID。搜索结果中的 app_id 可继续用于应用详情和评论。
`country`	body.params	`string`	否	-	App Store 店面国家/地区，使用小写代码，例如 us、cn、jp，默认 us。详情与评论都按该店面查询；应用在其他店面可见不代表在当前店面同样上架。
`limit`	body.params	`integer (1–200)`	否	`20`	这次调用最多返回的条数，整数，1–200；不传按默认值，实际返回可能少于这个数。超过上限会在扣费前返回 422。

代码示例

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": "search",
  "params": {
    "keyword": "habit tracker"
  }
}'

OpenAPI 定义 (JSON)示例从环境变量 EVERYINFRA_API_KEY 读取 Key，复制出去的代码不含你的 Key。

按应用名称或用途搜索；后续详情需数字 App ID，不是 Bundle ID。

响应示例

json

{  "id": "req_…",  "platform": "app_store",  "action": "search",  "results": [    {      "app_id": 1438388363,      "name": "Habit Tracker",      "url": "https://apps.apple.com/us/app/habit-tracker/id1438388363?uo=4",      "bundle_id": "com.davetech.habit",      "developer": "InnerGrow",      "developer_url": "https://apps.apple.com/us/developer/innergrow/id1828382777?uo=4",      "description": "Habit Tracker: A simple daily planner to schedule and track your routine, making it easy to build lasting habits. \nJoin 15M+ happy users, achieve your goals, and make every day count!\nMore than a self-care companion, it lets you share with others to grow and improve together. \n\n-…",      "release_notes": "- add shortcut supports \n- add custom repeat interval \n- fix bugs\n----- Beta Tester needed -----\nIf you want to help us to test new version, contact us: •••\nIf your widget is not working, restart your iPhone.\nOur IG: Tiny Useful Apps",      "version": "2.14.23",      "price": 0,      "currency": "USD",      "formatted_price": "Free",      "rating": 4.79,      "rating_count": 147260,      "current_version_rating_count": 147260,      "content_rating": "4+",      "category": "Productivity",      "icon_url": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/d3/ef/00/d3ef00c2-9b1c-b5ef-0464-2e08231b80de/AppIcon-pink-gr-0-0-1x_U007epad-0-1-0-sRGB-85-220.png/512x512bb.jpg",      "min_os": "15.0",      "file_size_bytes": 339836928,      "released_at": "2019-01-31T09:10:14+00:00",      "updated_at": "2026-08-15T15:18:18+00:00",      "platform": "app_store",      "genres": [        "Productivity",        "Health & Fitness"      ],      "languages": [        "EN",        "FR",        "DE"      ],      "screenshot_urls": [        "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/5c/b8/05/5cb8051e-e125-e84e-f0b5-2551b6e9d69d/_U767d1.jpg/320x480bb.jpg",        "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/13/5d/32/135d32df-678d-5c7e-d940-4f16d5c4e396/_U767d2.jpg/320x480bb.jpg",        "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/2e/a8/66/2ea866a0-2271-4d8a-e380-8386b935283f/_U767d3.jpg/320x480bb.jpg"      ],      "rating_scale": 5    },    {      "app_id": 6443918070,      "name": "Habit Tracker - HabitKit",      "url": "https://apps.apple.com/us/app/habit-tracker-habitkit/id6443918070?uo=4",      "bundle_id": "com.roehl.habitkit",      "developer": "Sebastian Roehl",      "developer_url": "https://apps.apple.com/us/developer/sebastian-roehl/id1602956482?uo=4",      "description": "Big life changes do not start big. They start with one small habit, done today, done again tomorrow. HabitKit turns those daily wins into a colorful grid of tiles, one square for every day you show up, so you can finally see yourself becoming the person you want to be.\n\nThat visi…",      "release_notes": "- Choose Yes/No, Count or Measure with decimals and custom units\n- Change habit types without losing history or streaks\n- At a Count goal above 1, tap to edit instead of clearing\n- New iOS Shortcuts to log amounts and notes, get progress and open habits; translated labels and cle…",      "version": "1.18.0",      "price": 0,      "currency": "USD",      "formatted_price": "Free",      "rating": 4.85,      "rating_count": 2430,      "current_version_rating_count": 2430,      "content_rating": "4+",      "category": "Productivity",      "icon_url": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/79/91/fe/7991fe78-b459-1397-205f-54525a639bde/NewAppIcon-0-0-1x_U007ephone-0-1-sRGB-85-220.png/512x512bb.jpg",      "min_os": "15.0",      "file_size_bytes": 230910976,      "released_at": "2022-11-26T08:00:00+00:00",      "updated_at": "2026-09-21T08:40:41+00:00",      "platform": "app_store",      "genres": [        "Productivity"      ],      "languages": [        "AR",        "BE",        "CA"      ],      "screenshot_urls": [        "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/cb/27/c1/cb27c143-49f7-12ba-a1f1-68fd4caf0634/Apple_iPhone_11_Pro_Max_Screenshot_0.png/320x480bb.jpg",        "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/18/ba/4e/18ba4eac-d29a-94ae-88a5-92204e14eb24/Apple_iPhone_11_Pro_Max_Screenshot_1.png/320x480bb.jpg",        "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/23/59/4e/23594e53-c451-7772-0dbb-7cd58b8470bb/Apple_iPhone_11_Pro_Max_Screenshot_2.png/320x480bb.jpg"      ],      "rating_scale": 5    }  ],  "count": 18,  "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 空结果: 没有数据，不扣费。

错误码