SeerMarTech API 文档

主题

Google Play 应用竞品分析（实时） ​

本接口用于获取与目标应用在 Google Play 排名上存在交集的竞品应用列表。你可以拿到竞品应用 ID，以及这些竞品在交叉上的搜索量和排名分布数据。

返回结果与请求中指定的 app_id 强分析该目标应用对应的竞品。

app_id 可从 Google Play 应用页 URL 中获取。例如：

https://play.google.com/store/apps/details?id=org.telegram.messenger

该应用的 app_id 为：

org.telegram.messenger

接口地址 ​

POST https://api.seermartech.cn/v3/dataforseo_labs/google/app_competitors/live

计费说明 ​

本接口按请求计费。

参考价约 ¥0.1760 / 次 扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

请求说明 ​

  • 请求方法：POST
  • 请求体格式：JSON
  • 编码：UTF-8
  • 请求体为 JSON 数组：[{ ... }]
  • 接口频率上限：最多 2000 次/分钟
  • 支持通过 limit 控制返回数量
  • 支持通过 filters 过滤结果
  • 支持通过 order_by 排序结果

请求参数 ​

字段名类型说明
app_idstring填。Google Play 应用 ID。可从应用页 URL 中获取。例如 org.telegram.messenger
location_namestring当未传 location_code 时填。地区名。二选一传 location_name 或 location_code。可通过 /v3/dataforseo_labs/locations_and_languages 获取可用地区。当前接口支持美国。示例：United States
location_codeinteger当未传 location_name 时填。地区编码。二选一传 location_name 或 location_code。可通过 /v3/dataforseo_labs/locations_and_languages 获取可用地区编码。当前接口支持美国。示例：2840
language_namestring当未传 language_code 时填。语言名。二选一传 language_name 或 language_code。可通过 /v3/dataforseo_labs/locations_and_languages 获取可用语言。当前接口支持英语。示例：English
language_codestring当未传 language_name 时填。语言代码。二选一传 language_name 或 language_code。可通过 /v3/dataforseo_labs/locations_and_languages 获取可用语言代码。当前接口支持英语。示例：en
filtersarray可选。结果过滤条件数组，最多支持 8 个过滤条件。多个条件之间可使用逻辑运算符 and、or 组合。支持的比较运算符：<、<=、>、>=、=、<>、in、not_in。过滤语法可参考 /v3/dataforseo_labs/filters
order_byarray可选。结果排序规则。可使用与 filters 相同的字段进行排序。排序方向支持：asc 升序、desc 降序。单次请求最多可设置 3 组排序规则
limitinteger可选。返回的最大竞品应用数量。默认值：100；最大值：1000
offsetinteger可选。结果偏移量。默认值：0。例如传 10 表示跳过前 10 条结果，从后续结果开始返回
tagstring可选。用户自定义任务标识，最长 255 个字符。可用于请求与响应结果的对应追踪；响应中的 data 对象会返回该值

过滤与排序 ​

过滤规则 ​

filters 支持多条件组合，例如：

json
[
 ["intersections", ">=", 500]
]

也可以使用逻辑连接符组合多个条件，例如 and / or。

排序规则 ​

order_by 用于指定返回结果的排序方式，例如按交叉数倒序排序：

json
["intersections,desc"]

返回结果说明 ​

接口返回 JSON 数据，顶层 tasks 数组，每个任务对应一次请求对象。

顶层字段 ​

字段名类型说明
versionstringAPI 当前版本
status_codeinteger接口通用状态码。完整错误码请参考 /v3/appendix/errors
status_messagestring接口通用状态信息
timestring接口执行耗时，单位秒
costfloat本次请求总费用，单位 USD
tasks_countintegertasks 数组中的任务数量
tasks_errorinteger返回错误的任务数量
tasksarray任务结果数组

tasks 数组字段 ​

字段名类型说明
idstring任务唯一标识，UUID 格式
status_codeinteger任务状态码，范围通常为 10000-60000
status_messagestring任务状态信息
timestring任务执行耗时
costfloat任务费用，单位 USD
result_countintegerresult 数组中的结果数量
patharray请求路径
dataobject回显请求参数
resultarray结果数组

result 数组字段 ​

字段名类型说明
se_typestring搜索引擎类型
app_idstring请求中的目标应用 ID
location_codeinteger请求中的地区编码
language_codestring请求中的语言代码
total_countinteger数据库中与本次请求匹的结果总数
items_countinteger本次 items 返回的结果数量
itemsarray竞品应用数据列表

items 数组字段 ​

字段名类型说明
se_typestring搜索引擎类型
app_idstring竞品应用 ID
avg_positionfloat该竞品在 Google Play 搜索结果中的平均排名。基于与目标应用存在交集的计算；同一竞品面对不同目标应用时，该值可能不同
sum_positioninteger该竞品在 Google Play 搜索结果中的排名总和。基于交叉计算；同一竞品面对不同目标应用时，该值可能不同
intersectionsinteger与目标应用存在交集的数量
competitor_metricsobject竞品在交叉维度下的排名指标
full_metricsobject竞品在排名维度下的完整指标

competitor_metrics 字段 ​

该对象描述的是：返回的竞品应用 与目标应用之间的交叉表现。

competitor_metrics.google_play_search_organic ​

字段名类型说明
pos_1integer竞品在自然搜索结果中排名第 1 的 SERP 数量
pos_2_3integer竞品在自然搜索结果中排名第 2-3 的 SERP 数量
pos_4_10integer竞品在自然搜索结果中排名第 4-10 的 SERP 数量
pos_11_100integer竞品在自然搜索结果中排名第 11-100 的 SERP 数量
countinteger含该竞品的自然搜索 SERP 总数
search_volumeinteger交叉在 Google Play 自然搜索中的总搜索量

full_metrics 字段 ​

该对象描述的是：竞品应用自身排名 的整体表现。

full_metrics.google_play_search_organic ​

字段名类型说明
pos_1integer竞品在自然搜索结果中排名第 1 的 SERP 数量
pos_2_3integer竞品在自然搜索结果中排名第 2-3 的 SERP 数量
pos_4_10integer竞品在自然搜索结果中排名第 4-10 的 SERP 数量
pos_11_100integer竞品在自然搜索结果中排名第 11-100 的 SERP 数量
countinteger含该竞品的自然搜索 SERP 总数
search_volumeinteger该竞品排名在 Google Play 自然搜索中的总搜索量

请求示例 ​

cURL ​

bash
curl --location --request POST "https://api.seermartech.cn/v3/dataforseo_labs/google/app_competitors/live" \
--header "Authorization: Bearer smt_live_YOUR_KEY" \
--header "Content-Type: application/json" \
--data-raw '[
 {
 "app_id": "org.telegram.messenger",
 "location_code": 2840,
 "language_name": "English",
 "filters": [
 ["intersections", ">=", 500]
 ],
 "limit": 10
 }
]'

Python ​

python
import requests

url = "https://api.seermartech.cn/v3/dataforseo_labs/google/app_competitors/live"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}
payload = [
 {
 "app_id": "org.telegram.messenger",
 "location_name": "United States",
 "language_name": "English",
 "filters": [
 ["intersections", ">=", 500]
 ],
 "limit": 10
 }
]

response = requests.post(url, json=payload, headers=headers)
print(response.json)

TypeScript ​

typescript
import axios from "axios";

const payload = [
 {
 app_id: "org.telegram.messenger",
 location_code: 2840,
 language_name: "English",
 filters: [
 ["intersections", ">=", 500]
 ],
 limit: 10
 }
];

axios({
 method: "post",
 url: "https://api.seermartech.cn/v3/dataforseo_labs/google/app_competitors/live",
 headers: {
 Authorization: "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
 },
 data: payload
})
 .then((response) => {
 console.log(response.data);
 })
 .catch((error) => {
 console.error(error);
 });

响应示例 ​

json
{
 "version": "0.1.20220428",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "1.5293 sec.",
 "cost": 0.011,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "api": "dataforseo_labs",
 "function": "app_competitors",
 "se_type": "google",
 "app_id": "org.telegram.messenger",
 "language_name": "English",
 "location_name": "United States",
 "limit": 10
 },
 "result": [
 {}
 ]
 }
 ]
}

状态码与错误处理 ​

  • 顶层 status_code 表示接口整体执行状态
  • tasks[].status_code 表示单个任务状态
  • 建议同时检查：
  • HTTP 状态码
  • 顶层 status_code
  • 各任务的 status_code

常见成功状态：

  • 20000：请求成功

完整错误码与状态说明请参考 /v3/appendix/errors。 建议在业务系统中做好时、参数校验失败、额限制与空结果等异常处理。

使用建议 ​

  1. 确认目标应用的 app_id 是否正确。
  2. 地区目前支持美国，语言支持英语，请传组合。
  3. 若需聚焦强竞争对手，可优按 intersections 过滤和排序。
  4. 若需分页获取更多结果，可结合 limit 与 offset 使用。
  5. 可将 competitor_metrics 与 full_metrics 结合分析，判断竞品是“在交集词强势”还是“整体自然流量强势”。

实用场景 ​

  • 识别直接竞品：基于交集找出与目标应用争夺同一搜索流量的应用，帮助产品和 ASO 团队快速锁定核心竞争对手。
  • 筛选高威胁应用：按 intersections、avg_position 或 search_volume 过滤排序，优定位对自然影响最大的竞品。
  • 拆解竞品自然搜索优势：结合 competitor_metrics.google_play_search_organic 判断竞品在 Top 1、Top 3、Top 10 的覆盖能力，为 ASO 词优化提供依据。
  • 评估竞品整体流量体量：通过 full_metrics 查看竞品排名的搜索量规模，判断在类目中的整体增长势能。
  • 监控应用竞争格局变化：定期拉取同一 app_id 的竞品结果，对比交叉数量和排名分布变化，及时发现新或老对手的增长趋势。

统一入口：官网 · LLM API · 控制台

© 2026 SeerMarTech · GEO · SEO 营销数据 API