点评口碑 · 数据 API

Google Play

Google Play API

用 Android 包名关联 Google Play 应用资料与评论,核对版本、广告和内购标记,并将用户反馈与已发布的开发者回复一起整理。 调用 POST /api/v1/social ;返回结构化 JSON,$1.39 / 千次;失败不计费。

3

个能力

$1.39 / 千次

能力价格

同步

调用模式

1 个

一把 Key 通用 89 个平台

Google Play 能力清单

action必填参数可选参数单次条数模式单价返回字段
searchkeywordcountry, language默认 20 · 最多 100同步$1.39 / 千次app_id · url · name · summary · description · developer · developer_email · developer_website · score · rating_count · review_count · installs · min_installs · price · is_free · currency · category · content_rating · contains_ads · offers_iap · version · released · updated_at · android_version · icon_url · header_image_url · privacy_policy · platform · screenshots · rating_histogram
profileapp_idcountry, language—同步$1.39 / 千次app_id · url · name · summary · description · developer · developer_email · developer_website · score · rating_count · review_count · installs · min_installs · price · is_free · currency · category · content_rating · contains_ads · offers_iap · version · released · updated_at · android_version · icon_url · header_image_url · privacy_policy · platform · screenshots · rating_histogram
reviewsapp_idcountry, language, sort默认 40 · 最多 200同步$1.39 / 千次id · app_id · text · title · score · author_name · author_avatar_url · thumbs_up · reply_text · reply_at · app_version · language · url · posted_at · platform

Google Play 每个接口分别做什么

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

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

怎么调用 Google Play 主页或对象详情 API?

profile

使用 platform="google_play"、action="profile" 调用“主页或对象详情”能力;返回单个对象,主要包含 app_id、url、name、summary、description、developer 等 30 个字段。

Google Play profile 的参数分别是什么意思?

app_id必填
Android 应用包名,例如 com.example.app,即 Play 商店链接 ?id= 后的值;不是 Apple App Store 的数字 ID。不要把完整 Play URL 填进 app_id,该值会作为包名直接使用。

Google 官方说明应用详情链接以 id 参数携带完整包名。EveryInfra app_id 因而应填写包名而不是应用显示名;country、language、资料字段、地区可见性和下架状态仍不能由链接格式文档保证。官方来源:Google Play:应用详情链接使用包名来源核查:

country可选
Google Play 店面国家/地区,建议小写代码,默认 us;它决定应用查询的店面,不是用户手机地区或应用开发者国籍。
language可选
Play 商店内容/评论查询语言,默认 en;例如 en 或 zh。它不自动更换 country,也不保证所有返回评论都是该语言的原文。
Google Play 特有返回字段与含义(19)
app_id
应用包名(如 com.example.app),Google Play 的唯一标识。
developer
开发者名称。
developer_email
开发者联系邮箱(商店页公开信息)。
developer_website
开发者网站。
score
应用评分,5 分制。
installs
安装量展示值(如 1,000,000+),是区间下限不是精确值。
min_installs
安装量区间下限的数值形式。
is_free
是否免费。
offers_iap
是否含内购。
contains_ads
是否含广告。
content_rating
内容分级。
android_version
要求的最低 Android 版本。
version
版本号。
released
首次发布日期。
updated_at
最近更新时间。长期不更新是维护风险信号。
summary
应用一句话简介。
icon_url
应用图标。
header_image_url
商店页头图。
privacy_policy
隐私政策链接。

怎么调用 Google Play 评价 API?

reviews

使用 platform="google_play"、action="reviews" 调用“评价”能力;返回列表,默认 40 条、单次最多 200 条,主要包含 id、app_id、text、title、score、author_name 等 15 个字段。

官方说明评分与评论可被用户更新,评论可关联版本、有用票和开发者回复;公开评价存在审核延迟,测试反馈并不公开。官方控制台与回复 API 的能力不等于本接口能力。官方来源:Google Play:应用评分、用户评论与开发者回复来源核查:

Google Play reviews 的参数分别是什么意思?

app_id必填
Android 应用包名,例如 com.example.app,即 Play 商店链接 ?id= 后的值;不是 Apple App Store 的数字 ID。不要把完整 Play URL 填进 app_id,该值会作为包名直接使用。
country可选
Google Play 店面国家/地区,建议小写代码,默认 us;它决定应用查询的店面,不是用户手机地区或应用开发者国籍。
language可选
Play 商店内容/评论查询语言,默认 en;例如 en 或 zh。它不自动更换 country,也不保证所有返回评论都是该语言的原文。
sort可选
应用评论顺序:newest 最新、top_rated 评分较高;reviews 默认 newest。只用于 reviews,不是应用搜索排名或应用总评分筛选。
查看全部 2 个允许值

newesttop_rated

Google Play 特有返回字段与含义(7)
app_id
应用包名(如 com.example.app),Google Play 的唯一标识。
score
应用评分,5 分制。
app_version
当前版本号。
thumbs_up
该评价的点赞数。
reply_text
开发者对评价的回复。
reply_at
开发者回复时间。
author_avatar_url
评价人头像。
Google Play search 调用流程一次 Google Play search 调用的全过程:向 POST /api/v1/social 发送 platform="google_play"、action="search",以及必填参数 keyword;返回结构化 JSON,含 app_id、url、name、summary、description 等字段;返回列表,单次最多 100 条,计费 $1.39 / 千次,失败与空结果不计费。1 · 请求POST /api/v1/socialplatform: "google_play"action: "search"keywordEveryInfra$1.39 / 千次2 · 响应 · 列表app_idurlnamesummarydescription
一次 Google Play search 调用的全过程:向 POST /api/v1/social 发送 platform="google_play"、action="search",以及必填参数 keyword;返回结构化 JSON,含 app_id、url、name、summary、description 等字段;返回列表,单次最多 100 条,计费 $1.39 / 千次,失败与空结果不计费。

Google Play 原始字段名

EveryInfra 统一字段名

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

Google Play 的独有字段名(当前目录)

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

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

返回字段含义

通用字段采用统一命名;切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。 机器可读版:/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 表示平台未公开。

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

请求填写示例

按 Android 应用名或用途搜索;详情使用包名,不是 App Store 数字 ID。

以下为填写格式示意,并非成功调用记录。请替换 API Key 和尖括号中的目标,确认可选筛选项后再调用;示例不保证目标当前有数据。

google_play_search.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer omg_你的KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"google_play","action":"search","params":{"keyword":"habit tracker"}}'

记录字段预览(非真实响应)

仅展示 search 的记录字段,不包含外层响应、计费或任务状态。null 只作展示占位,不表示字段类型或实际空值;完整响应须以接口文档与实际调用为准。

fields.preview.json
{
  "app_id": null,
  "url": null,
  "name": null,
  "summary": null,
  "description": null,
  "developer": null,
  "developer_email": null,
  "developer_website": null,
  "score": null,
  "rating_count": null,
  "review_count": null,
  "installs": null,
  "min_installs": null,
  "price": null,
  "is_free": null,
  "currency": null,
  "category": null,
  "content_rating": null,
  "contains_ads": null,
  "offers_iap": null,
  "version": null,
  "released": null,
  "updated_at": null,
  "android_version": null,
  "icon_url": null,
  "header_image_url": null,
  "privacy_policy": null,
  "platform": null,
  "screenshots": null,
  "rating_histogram": null
}

常见用例

以下是基于现有接口的接入思路,不是开箱即用的分析或告警功能。字段以实际返回为准,缺失值不按零处理。

怎样按应用用途发现 Google Play 竞品?

search 用 keyword 搜索应用名称或用途,例如 note taking,再按包名区分相似名称的应用。

查看 search 的 keyword 参数 →
  • keyword 是发现用的检索词,不是包名精确查询;搜索结果中的 app_id 才是后续详情和评论的定位键。当前目录仅开放 sort 作为附加参数,但它不是应用搜索排名筛选。
  • score、rating_count 与 review_count 分别描述评分值、评分数量和评论数量。installs 是商店安装量展示区间,min_installs 是其下限,不是精确下载次数或当前活跃用户。

怎样核对 Android 应用的版本与商业化信息?

profile 使用 app_id 指定 Android 包名,为某个 Play 商店应用建立版本和商店资料快照。

查看 profile 的 app_id 参数 →
  • app_id 填商店链接 ?id= 后的包名,如 com.example.app,不填完整 URL,也不是 Apple App Store 数字 ID。country 选择 Play 店面国家/地区,默认 us;language 选择内容语言,默认 en,两者不会互相替换。
  • version、android_version 与 updated_at 分别是应用版本、Android 要求和商店更新时间;is_free 不等于没有广告或内购,应同时看 contains_ads、offers_iap。price 与 currency 需成对读取,公开隐私链接不等于隐私合规认证。

怎样把 Google Play 版本反馈和开发者回复一起整理?

reviews 以应用包名定位评论,把用户评分、评论版本和开发者回复并排分析,找出更新后的具体问题。

查看 reviews 的 sort 参数 →
  • 必填 app_id;sort 可用 newest 或 top_rated。它控制评论顺序,不代表应用综合排行榜;评论可能被更新,公开显示也可能延迟,不保证即时或全量覆盖。
  • score 是该条评论评分,app_version 是该评论关联的应用版本,并非当前最新版本;thumbs_up 是有用票数。reply_text 与 reply_at 是已存在的开发者回复,本接口不发送回复,也不读取私有测试反馈。

Google Play API 常见问题

Google Play API 怎么调用?

调用 POST /api/v1/social,请求体传 platform="google_play"、action 和 params。以 search 为例,必填 keyword,可选 country、language。按 Android 应用名或用途搜索;详情使用包名,不是 App Store 数字 ID。 Google Play 共 3 个 action,鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 89 个平台。

Google Play API 怎么收费?

$1.39 / 千次,Google Play 全部 3 个能力同价。按本页最高能力单价、每次单目标估算,$1 免费额度约可用于 719 次 Google Play 调用。费用按所选能力与目标数量计算,多目标请求不要按单目标估算;参数错误、鉴权失败和空结果不计费。

Google Play API 一次能返回多少条数据?

Google Play 有 2 个列表接口,包括 search、reviews。其余 1 个接口返回单个对象;对象内仍可能包含数组。数量参数要逐接口区分目标数、页数和记录数,不能将目录数值直接当作保证返回的条数;具体限制见对应参数与用例,不保证完整历史。

Google Play API 返回哪些字段?

当前目录为 search 列出 app_id、url、name、summary、description、developer 等 30 个字段名。按全站当前目录统计,13 个字段名只在 Google Play 出现;这不表示其他平台没有同类信息。字段不保证每次齐全,嵌套位置、类型与空值须按各接口说明核对,同名字段不代表语义可互换。

怎样按应用用途发现 Google Play 竞品?

search 用 keyword 搜索应用名称或用途,例如 note taking,再按包名区分相似名称的应用。 keyword 是发现用的检索词,不是包名精确查询;搜索结果中的 app_id 才是后续详情和评论的定位键。当前目录仅开放 sort 作为附加参数,但它不是应用搜索排名筛选。 score、rating_count 与 review_count 分别描述评分值、评分数量和评论数量。installs 是商店安装量展示区间,min_installs 是其下限,不是精确下载次数或当前活跃用户。

怎样核对 Android 应用的版本与商业化信息?

profile 使用 app_id 指定 Android 包名,为某个 Play 商店应用建立版本和商店资料快照。 app_id 填商店链接 ?id= 后的包名,如 com.example.app,不填完整 URL,也不是 Apple App Store 数字 ID。country 选择 Play 店面国家/地区,默认 us;language 选择内容语言,默认 en,两者不会互相替换。 version、android_version 与 updated_at 分别是应用版本、Android 要求和商店更新时间;is_free 不等于没有广告或内购,应同时看 contains_ads、offers_iap。price 与 currency 需成对读取,公开隐私链接不等于隐私合规认证。

怎样把 Google Play 版本反馈和开发者回复一起整理?

reviews 以应用包名定位评论,把用户评分、评论版本和开发者回复并排分析,找出更新后的具体问题。 必填 app_id;sort 可用 newest 或 top_rated。它控制评论顺序,不代表应用综合排行榜;评论可能被更新,公开显示也可能延迟,不保证即时或全量覆盖。 score 是该条评论评分,app_version 是该评论关联的应用版本,并非当前最新版本;thumbs_up 是有用票数。reply_text 与 reply_at 是已存在的开发者回复,本接口不发送回复,也不读取私有测试反馈。

可以先免费试用 Google Play API 吗?

可以。注册免费,加微信领邀请码可得 $1 免费额度(≈720 次数据调用)。请先选择 Google Play 的目标接口,用单目标请求核对结果;实际可调用次数取决于能力价格与目标数量,不保证覆盖全部 3 个能力。无需信用卡。

开始调用 Google Play API

加微信领 $1 免费额度,先选一个 Google Play 接口验证结果。实际可调用次数取决于能力价格与目标数量。

免费开始