Google Play API

Google Play 每个接口分别做什么

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

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

{
  "platform": "google_play",
  "action": "bulk_metrics",
  "params": {
    "app_ids": [
      "com.spotify.music",
      "com.soundcloud.android"
    ]
  }
}

{
  "platform": "google_play",
  "action": "keyword_intersection",
  "params": {
    "app_ids": [
      "com.spotify.music",
      "com.soundcloud.android"
    ]
  }
}

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

Google Play 的独有字段名（当前目录）

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

• developer_email
• developer_website
• installs
• min_installs
• contains_ads
• offers_iap
• released
• android_version
• privacy_policy
• screenshots
• rating_histogram
• thumbs_up
• book_id

返回字段含义

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

app_id

应用包名（如 com.example.app），Google Play 的唯一标识。

url

该记录在原平台上的可访问链接。

name

名称。用于账号/商品/商家类能力，指该对象本身的名字。

summary

应用一句话简介。

description

简介或描述，通常比 text 短。

developer

开发者名称。

developer_email

开发者联系邮箱（商店页公开信息）。

developer_website

开发者网站。

score

应用评分，5 分制。

rating_count

参与评分的人数。null 表示不公开，不等于 0。

review_count

评价条数，用于商品/商家类能力。null 表示不公开，不等于 0。

installs

安装量展示值（如 1,000,000+），是区间下限不是精确值。

min_installs

安装量区间下限的数值形式。

price

价格数值，不含货币符号；币种见 currency。

is_free

是否免费下载。

currency

价格币种代码（如 CNY、USD）。price 存在但 currency 为 null 时不要假定币种。

category

分类名称，取值为原平台的分类体系，未做跨平台归一。

content_rating

内容分级。

contains_ads

是否含广告。

offers_iap

是否含内购。

version

版本号。

released

首次发布日期。

updated_at

最近更新时间。长期不更新是维护风险信号。

android_version

要求的最低 Android 版本。

icon_url

应用图标。

header_image_url

商店页头图。

privacy_policy

隐私政策链接。

platform

数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。

id

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

text

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

title

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

author_name

作者昵称（显示名）。

author_avatar_url

评价人头像。

thumbs_up

该评价的点赞数。

reply_text

开发者对评价的回复。

reply_at

开发者回复时间。

app_version

当前版本号。

language

内容语言代码（如 zh、en），由平台判定，可能不准。

posted_at

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

search_rank

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

ranked_at

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

rating

评分。分制随平台而异，同一行的 rating_scale 给出该平台满分 (多数是 5，Booking/豆瓣/爱奇艺/NAVER 是 10)。跨平台比较前必须先按 rating_scale 换算。直接比数字会得出反的结论。

rating_scale

上一列 rating 的满分。5 表示五星制、10 表示十分制。只在该行有 rating 时出现。

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），每行相同。

book_id

Google Play 图书 ID（books），图书详情页链接 ?id= 后的值。

author

作者（books）。

format

图书形式（books）：ebook 电子书、audiobook 有声书、series 系列。

cover_url

封面图（books）。

rank

在这次榜单或浏览结果里的名次（games），从 1 开始。

rankings

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

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