SeerMarTech API 文档

主题

创建 Apple App Reviews 采集任务 ​

该接口用于创建 Apple App Store 应用评论采集任务。创建任务后，本平台会根据指定的 app_id、语言和地区抓取对应应用的评论数据。

返回结果针对你指定的语言和地区生效，因此在请求中需要提供语言与地区参数之一组合：

  • 地区：location_name 或 location_code
  • 语言：language_name 或 language_code

app_id 可从 App Store 应用页 URL 中获取，即 id 后面的数字。例如：

https://apps.apple.com/us/app/id835599320

该应用的 app_id 为：

835599320

接口地址 ​

POST https://api.seermartech.cn/v3/app_data/apple/app_reviews/task_post

计费说明 ​

本接口的费用由两部分组成：

  • 创建任务的基础费用
  • 返回评论数量对应的费用

评论按每 50 条为一个计费单位计费。例如：

  • 设置 "depth": 50：按 50 条评论计费
  • 设置 "depth": 51：按 100 条评论计费

建议将 depth 设置为 50 的整数倍，因为系统按每批 50 条评论处理。

如参考单价有变动，扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

请求说明 ​

  • 请求方法：POST
  • 请求体格式：application/json
  • 编码：UTF-8
  • 请求体为 JSON 数组，格式为 [{ ... }]

速率与任务上限 ​

  • 每分钟最多可发起 2000 次 API 调用
  • 每次 POST 请求最多可 100 个任务
  • 若单次请求 100 个任务，出部分将返回错误 40006

回调说明 ​

任务创建后，你可以通过任务 id 获取结果；也可以在创建任务时传：

  • postback_url：任务完成后，本平台将以 POST 方式把结果（gzip 压缩）推送到该地址
  • pingback_url：任务完成后，本平台将以 GET 方式通知该地址

支持在回调 URL 中使用以下变量：

  • $id：任务 ID
  • $tag：你提交的自定义标签，发送前会进行 URL 编码

示例：

  • http://your-server.com/postbackscript?id=$id
  • http://your-server.com/postbackscript?id=$id&tag=$tag

注意事项：

  • postback_url 或 pingback_url 中的特殊字符会被 URL 编码
  • 例如 # 会被编码为 %23
  • 若你的服务器在 10 秒未响应，连接会因时中断，任务会转 /v3/app_data/apple/app_reviews/tasks_ready 列表，可后续主动拉取

请求参数 ​

字段名类型说明
app_idstring填。App Store 应用 ID，可从应用 URL 中获取。例如 https://apps.apple.com/us/app/id835599320 中的 ID 为 835599320。
location_namestring搜索地区完整名称。当未提供 location_code 时填。如果使用该字段，则无需提供 location_code。地区列表可通过 /v3/app_data/apple/locations 获取。例如：West Los Angeles,California,United States
location_codeinteger搜索地区代码。当未提供 location_name 时填。如果使用该字段，则无需提供 location_name。地区列表可通过 /v3/app_data/apple/locations 获取。例如：9061121
language_namestring语言完整名称。当未提供 language_code 时填。如果使用该字段，则无需提供 language_code。语言列表可通过 /v3/app_data/apple/languages 获取。例如：English
language_codestring语言代码。当未提供 language_name 时填。如果使用该字段，则无需提供 language_name。语言列表可通过 /v3/app_data/apple/languages 获取。例如：en
priorityinteger任务优级，可选。取值：1 = 普通优级（默认），2 = 高优级。高优级通常执行更快，但会产生额外费用，扣费以响应头 X-SeerMarTech-Charge-CNY 为准。
depthinteger采集深度，可选。表示希望返回的评论数量。默认值：50；最大值：500。建议设置为 50 的整数倍。 50 条时，可能产生额外费用。
sort_bystring排序方式，可选。可选值：most_recent（按最新评论排序）、most_helpful（按最/最有帮助排序）。默认：most_helpful
tagstring自定义任务标识，可选。最大长度 255 字符。可用于后续将结果与业务系统中的任务进行；返回结果中的 data 对象会该值。
postback_urlstring结果推送地址，可选。任务完成后，本平台会将结果以 gzip 压缩后的 POST 请求发送到该地址。支持 $id 和 $tag 变量。
postback_datastringpostback_url 的数据类型。当指定 postback_url 时填。当前可用值：advanced
pingback_urlstring完成通知地址，可选。任务完成后，本平台会向该地址发送 GET 请求通知。支持 $id 和 $tag 变量。

请求示例 ​

curl ​

bash
curl --location --request POST "https://api.seermartech.cn/v3/app_data/apple/app_reviews/task_post" \
--header "Authorization: Bearer smt_live_YOUR_KEY" \
--header "Content-Type: application/json" \
--data-raw '[
 {
 "app_id": "835599320",
 "location_code": 2840,
 "language_code": "en",
 "depth": 200
 }
]'

Python ​

python
import requests

url = "https://api.seermartech.cn/v3/app_data/apple/app_reviews/task_post"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}
data = [
 {
 "app_id": "835599320",
 "location_code": 2840,
 "language_code": "en",
 "depth": 200
 },
 {
 "app_id": "835599320",
 "location_code": 2840,
 "language_code": "en",
 "depth": 200,
 "priority": 2
 },
 {
 "app_id": "835599320",
 "location_code": 2840,
 "language_code": "en",
 "postback_data": "advanced",
 "postback_url": "https://your-server.com/postbackscript"
 }
]

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

TypeScript ​

typescript
import axios from "axios";

const postData = [
 {
 app_id: "835599320",
 location_code: 2840,
 language_code: "en",
 depth: 200
 }
];

axios({
 method: "post",
 url: "https://api.seermartech.cn/v3/app_data/apple/app_reviews/task_post",
 headers: {
 Authorization: "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
 },
 data: postData
})
 .then((response) => {
 // 返回任务创建结果
 console.log(response.data);
 })
 .catch((error) => {
 console.error(error);
 });

响应说明 ​

接口返回 JSON 数据，任务创建结果及任务信息。

顶层字段 ​

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

tasks 数组字段 ​

字段名类型说明
idstring系统中的唯一任务 ID，UUID 格式
status_codeinteger任务状态码，范围通常为 10000-60000
status_messagestring任务状态信息
timestring任务处理耗时，单位秒
costfloat单个任务费用，单位 USD
result_countintegerresult 数组中的数量
patharray请求路径
dataobject与提交时请求参数一致的任务数据
resultarray结果数组。对于创建任务接口，此处通常为 null

响应示例 ​

json
{
 "version": "0.1.20220422",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.0683 sec.",
 "cost": 0.006,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
 "status_code": 20100,
 "status_message": "Task Created.",
 "time": "0.0000 sec.",
 "cost": 0.006,
 "result_count": 0,
 "path": [
 "v3",
 "app_data",
 "apple",
 "app_reviews",
 "task_post"
 ],
 "data": {
 "api": "app_data",
 "function": "app_reviews",
 "se": "apple",
 "app_id": "835599320",
 "location_code": 2840,
 "language_code": "en",
 "depth": 200,
 "se_type": "reviews",
 "device": "desktop",
 "os": "windows"
 },
 "result": null
 }
 ]
}

状态码说明 ​

状态码说明
20000请求成功
20100任务已创建
40006单次 POST 请求中的任务数 100 个
10000-60000任务级状态码范围，含义可参考 /v3/appendix/errors

建议在接时对通用状态码和任务状态码分别进行处理，以便更准确地识别请求异常、参数错误和任务执行问题。

使用建议 ​

  1. 优使用 location_code 与 language_code，便于程序化处理
  2. 将 depth 设为 50、100、150、200 等值，可减少计费与结果预期不一致的问题
  3. 若任务量较大，建议结合 tag 做业务
  4. 对于异步处理流程，推荐使用 postback_url 或 pingback_url
  5. 回调服务需确保 10 秒完成响应，任务拉取列表

实用场景 ​

  • 监控应用口碑变化：定期抓取指定国家和语言下的最新评论，及时发现评分下降、差评集中等问题。
  • 分析本地化反馈：按不同地区与语言采集评论，识别翻译问题、功能适问题和市场差异化需求。
  • 挖掘用户痛点：通过批量获取评论，为产品团队整理高频投诉、功能缺失和体验障碍。
  • 跟踪版本发布效果：在新版本上线后抓取最新评论，评估新功能上线后的用户反馈和稳定性表现。
  • 支撑竞品研究：对竞品应用在不同市场的评论进行采集，了解优势功能、用户偏好和负面反馈。

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

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