SeerMarTech 文档控制台

应用评价（异步）

异步抓取 Google Play 应用用户评价，含评分、评论文本、版本等。

Step 1：提交任务

POST/v3/app_data/google/app_reviews/task_post
参考价：约 ¥0.8000 / 次（实际以请求返回为准）
参数类型必填说明
app_idstring是Google Play 应用包名
location_codeinteger否地区代码
language_codestring否语言代码
depthinteger否抓取评价数量
sort_bystring否newest / rating

curl

curl -X POST "https://api.seermartech.cn/v3/app_data/google/app_reviews/task_post" \
  -H "Authorization: Bearer smt_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"app_id": "com.example.app", "location_code": 2840, "language_code": "en", "depth": 100}]'

Python

import time
import requests
 
API_KEY = "smt_live_YOUR_KEY"
BASE = "https://api.seermartech.cn/v3"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}
 
post = requests.post(
    f"{BASE}/app_data/google/app_reviews/task_post",
    headers={**HEADERS, "Content-Type": "application/json"},
    json=[{"app_id": "com.example.app", "location_code": 2840, "language_code": "en", "depth": 100}],
    timeout=60,
)
task_id = post.json()["tasks"][0]["id"]
 
for _ in range(30):
    get = requests.get(f"{BASE}/app_data/google/app_reviews/task_get/{task_id}", headers=HEADERS, timeout=60)
    data = get.json()
    if data["tasks"][0]["status_code"] == 20000:
        print(len(data["tasks"][0]["result"][0]["items"]), "reviews")
        break
    time.sleep(10)

TypeScript

const resp = await fetch(
  "https://api.seermartech.cn/v3/app_data/google/app_reviews/task_post",
  {
    method: "POST",
    headers: {
      Authorization: "Bearer smt_live_YOUR_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify([{
      app_id: "com.example.app",
      location_code: 2840,
      language_code: "en",
      depth: 100,
    }]),
  }
);
console.log((await resp.json()).tasks[0].id);

Step 2：获取结果

GET/v3/app_data/google/app_reviews/task_get/{task_id}

业务场景