获取 Apple App Info 高级结果（按任务 ID）

接口说明

该接口用于按任务 ID 获取 Apple App Info 采集结果。返回对应您在创建任务时传的 app_id，可应用的基础信息与数据，例如：

应用 ID
图标
标题
描述
评论数
评分
图片
开发信息
类别
更新说明
相似应用等

本接口返回的是已创建任务的结果数据，因此调用前需要通过对应的 POST 接口创建任务，再使用任务 ID 获取结果。

为尽可能贴近真实页面结果，平台 API 会高精度模拟任务提交时的查询参数。您也可以使用响应中的 check_url 在无痕模式下打开对应页面，以校验结果性。需要注意的是，个性化因素（如用户偏好、搜索历史等）不会被纳结果计算。

请求方式

GET https://api.seermartech.cn/v3/app_data/apple/app_info/task_get/advanced/$id

路径参数

字段	类型	说明
`id`	string	任务唯一标识，UUID 格式。任务结果可在 30 天重复获取。

计费说明

您在创建任务时产生费用，任务结果在后续 30 天可重复获取。

当前结果查询接口本身通常不额外收费；扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

Sandbox

您可以使用以下 Sandbox 地址查看该接口可返回的完整字段结构，字段值为模拟数据：

https://sandbox.本平台.com/v3/app_data/apple/app_info/task_get/advanced/00000000-0000-0000-0000-000000000000

Sandbox 调用不计费。

返回结构

接口返回 JSON 数据，顶层 tasks 数组。

顶层字段

字段	类型	说明
`version`	string	当前 API 版本。
`status_code`	integer	通用状态码。完整错误码请参考 `/v3/appendix/errors`。建议在业务中做好异常处理。
`status_message`	string	通用状态信息。
`time`	string	执行耗时，单位秒。
`cost`	float	本次请求总成本，单位 USD。
`tasks_count`	integer	`tasks` 数组中的任务数量。
`tasks_error`	integer	返回错误的任务数量。
`tasks`	array	任务结果数组。

tasks[] 字段

字段	类型	说明
`id`	string	任务 ID，UUID 格式。
`status_code`	integer	任务状态码，范围通常为 `10000-60000`。
`status_message`	string	任务状态说明。
`time`	string	任务执行耗时，单位秒。
`cost`	float	该任务成本，单位 USD。
`result_count`	integer	`result` 数组中的数量。
`path`	array	URL 路径。
`data`	object	与创建任务时一致的请求参数。
`result`	array	结果数组。

result[] 字段

字段	类型	说明
`app_id`	string	POST 请求中提交的应用 ID。
`se_domain`	string	创建任务时使用的搜索引擎域名。
`location_code`	integer	创建任务时使用的位置编码。
`language_code`	string	创建任务时使用的语言编码。
`check_url`	string	用于校验结果的页面直达链接。建议在无痕模式下访问。
`datetime`	string	结果抓取时间，UTC 格式：`yyyy-mm-dd hh-mm-ss +00:00`。
`se_results_count`	integer	结果总数。
`items_count`	integer	`items` 数组中的项目数量。
`items`	array	应用结果。

items[] 字段

字段	类型	说明
`type`	string	结果项类型。当前可能值：`app_store_info_organic`
`rank_group`	integer	相同 `type` 分组的排名。
`rank_absolute`	integer	所有应用中的绝对排名。
`position`	string	结果位置。当前可能值：`left`
`app_id`	string	应用 ID。
`title`	string	应用标题。
`url`	string	App Store 应用页链接。
`icon`	string	应用图标链接。
`description`	string	应用描述。
`reviews_count`	integer	应用总评论数。
`rating`	object	平均评分信息。
`price`	object	应用价格信息。
`main_category`	string	主类别 / 主分类。
`categories`	array	类别列表。注意：当前通常返回一个类别。
`languages`	array	支持语言列表。注意：当前通常返回一种语言。
`advisories`	array	年龄分级与提示。
`developer`	string	开发名称。
`developer_id`	string	开发 ID。
`developer_url`	string	开发在 App Store 的页面链接。
`version`	string	应用当前版本。
`minimum_os_version`	string	安所需最低系统版本。
`size`	string	应用大小。
`released_date`	string	应用发布时间。该字段已废弃，始终返回 `null`。
`last_update_date`	string	最近更新时间，UTC 格式。
`update_notes`	string	最新版本更新说明。
`images`	array	应用页图片链接列表。
`similar_apps`	array	相似应用列表。
`more_apps_by_developer`	array	同一开发的应用列表。

rating 对象字段

字段	类型	说明
`rating_type`	string	评分类型。当前可能值：`Max5`
`value`	float	评分值。
`votes_count`	integer	反馈数量；该场景下可能返回 `null`。
`rating_max`	integer	当前评分体系下的最大值；`Max5` 的最大值为 `5`。

price 对象字段

字段	类型	说明
`current`	float	当前价格。
`regular`	float	常规价格。
`max_value`	float	最大价格。
`currency`	string	价格币种，ISO 货币代码。
`is_price_range`	boolean	是否为价格区间。
`displayed_price`	string	页面展示的原始价格文本。
`is_free`	boolean	是否为应用。

similar_apps[] / more_apps_by_developer[] 字段

字段	类型	说明
`app_id`	string	应用 ID。
`title`	string	应用标题。
`url`	string	App Store 应用页链接。

调用示例

cURL

bash

id="04011058-0696-0199-0000-2196151a15cb"

curl --location --request GET "https://api.seermartech.cn/v3/app_data/apple/app_info/task_get/advanced/${id}" \
 --header "Authorization: Bearer smt_live_YOUR_KEY" \
 --header "Content-Type: application/json"

Python

python

import requests

task_id = "06141103-2692-0309-1000-980b778b6d25"
url = f"https://api.seermartech.cn/v3/app_data/apple/app_info/task_get/advanced/{task_id}"

headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}

response = requests.get(url, headers=headers)
data = response.json

print(data)

TypeScript

typescript

import axios from "axios";

const taskId = "02231934-2604-0066-2000-570459f04879";

axios({
 method: "get",
 url: `https://api.seermartech.cn/v3/app_data/apple/app_info/task_get/advanced/${taskId}`,
 headers: {
 Authorization: "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json",
 },
})
 .then((response) => {
 // 返回结果
 console.log(response.data);
 })
 .catch((error) => {
 console.error(error);
 });

响应示例

json

{
 "version": "0.1.20251117",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.1548 sec.",
 "cost": 0,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "se_type": "app_info",
 "api": "app_data",
 "function": "app_info",
 "se": "apple",
 "app_id": "835599320",
 "location_code": 2840,
 "language_code": "en",
 "device": "desktop",
 "os": "windows"
 },
 "result": [
 {
 "developer": "TikTok Ltd.",
 "developer_id": "1322881000",
 "developer_url": "https://apps.apple.com/us/developer/tiktok-ltd/id1322881000",
 "version": "Version 42.6.0",
 "minimum_os_version": "Requires iOS 12.0 or later.",
 "size": "701.6 MB",
 "released_date": null,
 "last_update_date": "2025-11-19 00:18:20 +00:00",
 "update_notes": "Add the latest stickers to your videos.",
 "images": [],
 "similar_apps": [],
 "more_apps_by_developer": []
 }
 ]
 }
 ]
}

状态码与错误处理

顶层 status_code 表示整次请求的执行状态。
tasks[].status_code 表示单个任务的执行状态。
建议同时校验：
HTTP 状态码
顶层 status_code
任务级 tasks[].status_code
result 是否为空

完整错误码说明请参考 /v3/appendix/errors。

使用建议

调用任务提交接口创建 Apple App Info 任务。
通过任务就绪接口获取已完成任务，或直接使用已知任务 ID 查询。
获取结果后，使用 check_url 抽样校验结果准确性。
若需长期保存，请在 30 天有效期完成结果拉取与库。

实用场景

监控应用页变化：定期抓取应用标题、描述、图标、截图和更新说明，及时发现商店页素材变更，支持 ASO 优化。
跟踪评分与评论表现：采集 rating 与 reviews_count，评估版本发布后的用户反馈趋势，产品与运营迭代。
分析竞品页面策略：抓取竞品的分类、描述、截图和相似应用，识别页面方式与流量承接策略。
识别开发矩阵布局：通过 developer_id、developer_url 和 more_apps_by_developer 分析同开发产品组合，竞品研究。
评估上架门槛与容性：利用 minimum_os_version、size、languages、advisories 等字段，判断目标应用的用户覆盖范围与市场适策略。

获取 Apple App Info 高级结果（按任务 ID） ​

接口说明 ​

请求方式 ​

路径参数 ​

计费说明 ​

Sandbox ​

返回结构 ​

顶层字段 ​

tasks[] 字段 ​

result[] 字段 ​

items[] 字段 ​

rating 对象字段 ​

price 对象字段 ​

similar_apps[] / more_apps_by_developer[] 字段 ​

调用示例 ​

cURL ​

Python ​

TypeScript ​

响应示例 ​

状态码与错误处理 ​

使用建议 ​

实用场景 ​