App Store API

App Store 每个接口分别做什么

下面逐个解释 action、必填参数、可选筛选项和允许值。 请求都发到 POST /api/v1/social， 切换 action 时，也要按对应接口调整参数。 同名参数在不同平台、不同接口中可能指向不同对象；请以该条说明中的格式和适用范围为准。

下方只展示平台官方资料，用于核对对象与术语，不表示平台对 EveryInfra 的授权或背书。 本接口接受的参数、字段与能力边界以各条说明为准，不与平台官方 API 直接等同。

{
  "platform": "app_store",
  "action": "bulk_metrics",
  "params": {
    "app_ids": [
      "324684580",
      "1017492454"
    ]
  }
}

{
  "platform": "app_store",
  "action": "keyword_intersection",
  "params": {
    "app_ids": [
      "324684580",
      "1017492454"
    ]
  }
}

左边是 App Store 数据里原本的字段名，右边是我们统一后的。点任意一行看对应关系。106 个平台复用通用字段命名，减少重复适配； 切换平台仍需核对参数、字段集合、类型与空值含义。这里展示映射关系，不是目标的实时返回数据。

App Store 的独有字段名（当前目录）

全站 106 个平台的当前目录中，这 11 个字段名只在 App Store 出现。 这是字段命名的分布，不代表其他平台没有同类信息，也不保证每次响应都含这些字段；具体含义和返回条件仍需逐接口核对。

• bundle_id
• developer_id
• developer_url
• release_notes
• formatted_price
• current_version_rating
• current_version_rating_count
• min_os
• file_size_bytes
• screenshot_urls
• app_name

返回字段含义

通用字段采用统一命名；切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。 机器可读版：/api/v1/social/fields

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

应用截图链接数组，按商店展示顺序；没有时不出现这个字段。

id

该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。

title

标题。平台无标题概念时（如纯文本帖）为 null。

text

正文内容，已去除 HTML 标签，全文返回、不截断（个别平台的列表结果本身只有摘要，以该平台的字段说明为准）。

author

评价作者。

app_version

版本号。

helpful_count

评价被标「有帮助」次数。

posted_at

发布时间，ISO 8601 格式、UTC 时区（如 2026-08-07T12:34:56+00:00）。平台只给非标准字符串时原样透传，解析前建议做容错。null 表示平台未公开。

app_name

应用名称。

search_rank

这个 App 在该关键词的商店搜索结果里排第几（keywords_for_app，从 1 开始）。

search_result_count

该关键词在商店里搜出的 App 总数（keywords_for_app）。

ranked_at

这个关键词的排名和搜索量最近一次更新的时间（keywords_for_app，ISO）；数据按周到按月刷新，不是实时。

is_free

是否免费下载（keywords_for_app）。

total_keywords

这个 App 一共有多少个排得上的关键词（keywords_for_app），或这组 App 一共有多少个共同关键词（keyword_intersection）；每行相同，limit 只决定这次给前多少个。

keyword_count

这个 App 排得上的关键词总数（bulk_metrics、competitors）。

top1_keywords

排第 1 的关键词个数（bulk_metrics）。

top3_keywords

排进前 3 的关键词个数（bulk_metrics，含第 1）。

top10_keywords

排进前 10 的关键词个数（bulk_metrics、competitors，含前 3）。

keywords_search_volume

排得上的关键词，月搜索量合计（bulk_metrics）。

shared_keywords

这个竞品和目标 App 都排得上的关键词个数（competitors），按它从多到少排。

avg_position

竞品在共同关键词下的平均名次（competitors），越小越靠前。

shared_top10_keywords

共同关键词里，竞品排进前 10 的个数（competitors）。

shared_search_volume

共同关键词的月搜索量合计（competitors）。

target_app_id

这次查的目标 App（competitors），每行相同。

rankings

这组 App 各自在该关键词下的名次（keyword_intersection），按传入顺序，每项有 app_id、search_rank、title、url。

当前目录另列出 keyword · search_volume，这些字段尚无逐项释义；请先核对 App Store 对应接口的用例与实际响应，不按字段名猜测类型或含义。