设置 Google 商家动态任务

POST /v3/business_data/google/my_business_updates/task_post

本接口使用 POST 方法，路径为：

/v3/business_data/google/my_business_updates/task_post

用于提交 Google 搜索结果中指定商家实体的最新动态采集任务。返回结果取决于所选的地区和语言设置。地区可参考 /v3/business_data/google/locations/，语言可参考 /v3/business_data/google/languages/。

计费与请求限制

提交任务会产生费用，参考价约 ¥0.0162 / 个任务。高优级任务可能产生额外费用，扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

请求要求如下：

请求体使用 UTF-8 编码的 JSON 格式。
POST 请求体是 JSON 数组。平台限流以认证说明中的 30/60/120 次/分钟规则为准。
单次请求最多 100 个任务。 -出 100 个任务的部分将返回错误码 40006。
任务提交成功后，可通过返回的任务 ID 查询结果。
也可以在请求中设置 postback_url 或 pingback_url，在任务完成后接收通知。
如果回调服务器在 10 秒未响应，连接将因时中止，任务会转任务就绪列表。

请求参数

请求体中的每个数组代表一个任务。

参数	类型	填	说明
`keyword`	string	是	商家名称或商家唯一标识。最多 700 个字符。所有 `%##` 编码会被解码，字符 `+` 会被解码为空格。若中需要使用 `%`，请传递 `%25`。该字段也可传 `cid` 或 `place_id`。例如：`cid:194604053573767737`、`place_id:GhIJQWDl0CIeQUARxks3icF8U8A`。
`priority`	integer	否	任务优级：`1` 表示普通优级，默认值为 `1`；`2` 表示高优级。高优级任务可能产生额外费用。
`location_name`	string	条件填	搜索地区的完整名称。当未提供 `location_code` 或 `location_coordinate` 时填。使用该字段后，无需再提供另外两个地区参数。例如：`London,England,United Kingdom`。
`location_code`	integer	条件填	搜索地区代码。当未提供 `location_name` 或 `location_coordinate` 时填。使用该字段后，无需再提供另外两个地区参数。例如：`2840`。可通过 `/v3/business_data/google/locations` 获取可用地区代码。
`location_coordinate`	string	条件填	地区 GPS 坐标，格式为 `latitude,longitude,radius`。纬度和经度最多支持 7 位小数，`radius` 最小值为 `199.9`。例如：`53.476225,-2.243572,200`。
`language_name`	string	条件填	搜索语言的完整名称。当未提供 `language_code` 时填。使用该字段后，无需再提供 `language_code`。例如：`English`。
`language_code`	string	条件填	搜索语言代码。当未提供 `language_name` 时填。使用该字段后，无需再提供 `language_name`。例如：`en`。可通过 `/v3/business_data/google/languages` 获取可用语言代码。
`depth`	integer	否	解析深度，即需要采集的动态数量。建议设置为 10 的倍数，因为系统会按每批 10 条动态进行处理。Google 最多返回 4490 条动态。默认值为 `10`。
`tag`	string	否	自定义任务标识，最多 255 个字符。可用于任务与结果。提交的值会原样返回在响应的 `data` 对象中。
`postback_url`	string	否	任务完成后接收结果的 URL。本平台将向该地址发送经过 gzip 压缩的 POST 请求。URL 中可使用 `$id` 和 `$tag` 占位符，平台发送请求前会替换为任务 ID 和经过 URL 编码的标签值。例如：`https://your-server.com/postbackscript?id=$id&tag=$tag`。特殊字符会进行 URL 编码，例如 `#` 会编码为 `%23`。
`pingback_url`	string	否	任务完成后的通知 URL。任务完成后，本平台会向该地址发送 GET 请求。URL 中可使用 `$id` 和 `$tag` 占位符。例如：`https://your-server.com/pingscript?id=$id&tag=$tag`。特殊字符会进行 URL 编码。

地区参数说明

location_name、location_code 和 location_coordinate 三只能选择一。

可用地区列表：

https://api.seermartech.cn/v3/business_data/google/locations

语言参数说明

language_name 和 language_code 二只能选择一。

可用语言列表：

https://api.seermartech.cn/v3/business_data/google/languages

请求示例

curl

bash

curl --location --request POST \
  "https://api.seermartech.cn/v3/business_data/google/my_business_updates/task_post" \
  --header "Authorization: Bearer smt_live_YOUR_KEY" \
  --header "Content-Type: application/json" \
  --data-raw '[
    {
      "location_code": 1023191,
      "language_code": "en",
      "keyword": "RustyBrick, Inc."
    },
    {
      "location_name": "New York,New York,United States",
      "language_name": "English",
      "keyword": "RustyBrick, Inc.",
      "priority": 2,
      "tag": "some_string_123",
      "pingback_url": "https://your-server.com/pingscript?id=$id&tag=$tag"
    }
  ]'

Python

python

import requests

url = "https://api.seermartech.cn/v3/business_data/google/my_business_updates/task_post"

payload = [
    {
        "location_code": 1023191,
        "language_code": "en",
        "keyword": "RustyBrick, Inc."
    },
    {
        "location_name": "New York,New York,United States",
        "language_name": "English",
        "keyword": "RustyBrick, Inc.",
        "priority": 2,
        "tag": "some_string_123",
        "pingback_url": "https://your-server.com/pingscript?id=$id&tag=$tag"
    }
]

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

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

TypeScript

typescript

import axios from "axios";

const taskData = [
  {
    location_name: "New York,New York,United States",
    language_name: "English",
    keyword: "RustyBrick, Inc.",
    priority: 2,
    tag: "some_string_123",
    pingback_url:
      "https://your-server.com/pingscript?id=$id&tag=$tag",
  },
];

axios
  .post(
    "https://api.seermartech.cn/v3/business_data/google/my_business_updates/task_post",
    taskData,
    {
      headers: {
        Authorization: "Bearer smt_live_YOUR_KEY",
        "Content-Type": "application/json",
      },
    }
  )
  .then((response) => {
    console.log(response.data);
  })
  .catch((error) => {
    console.error(error.response?.data || error.message);
  });

响应结构

接口返回 tasks 数组的 JSON 数据。

字段	类型	说明
`version`	string	当前 API 版本。
`status_code`	integer	请求级状态码。成功通常为 `20000`。
`status_message`	string	请求级状态说明。
`time`	string	请求执行耗时，单位为秒。
`cost`	float	平台原始 USD 成本兼容字段；人民币实扣以 `X-SeerMarTech-Charge-CNY` 为准。
`tasks_count`	integer	`tasks` 数组中的任务数量。
`tasks_error`	integer	`tasks` 数组中返回错误的任务数量。
`tasks`	array	已提交任务的信息。

`tasks` 数组字段

字段	类型	说明
`id`	string	任务唯一标识，UUID 格式。
`status_code`	integer	任务状态码，通常位于 `10000` 至 `60000` 范围。
`status_message`	string	任务状态说明。
`time`	string	任务执行耗时，单位为秒。
`cost`	float	平台原始 USD 成本兼容字段；人民币实扣以 `X-SeerMarTech-Charge-CNY` 为准。
`result_count`	integer	`result` 数组中的数量。
`path`	array	请求路径信息。
`data`	object	创建任务时提交的参数。
`result`	array	任务结果。对于任务提交接口，该字段为 `null`。

响应示例

json

{
  "version": "0.1.20200909",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "0.0981 sec.",
  "cost": 0.0162,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "status_code": 20100,
      "status_message": "Task Created.",
      "time": "0.0100 sec.",
      "cost": 0.0162,
      "result_count": 0,
      "path": [
        "v3",
        "business_data",
        "google",
        "my_business_updates",
        "task_post"
      ],
      "data": {
        "api": "business_data",
        "function": "my_business_updates",
        "se": "google",
        "language_code": "en",
        "location_name": "New York,New York,United States",
        "keyword": "RustyBrick, Inc.",
        "se_type": "business_updates",
        "device": "desktop",
        "os": "windows"
      },
      "result": null
    }
  ]
}

状态码与错误处理

20000：请求成功。
40006：单次请求提交的任务数量 100 个。
tasks_error 大于 0：表示部分或任务提交失败，应进一步检查对应任务对象中的 status_code 和 status_message。

建议在业务系统中同时处理请求级状态码和任务级状态码，并记录 id、tag 及错误信息，便于后续查询和问题追踪。

实用场景

监控商家动态更新：批量采集指定门店在 Google 搜索结果中的最新动态，及时发现促销、和营业信息变化。
对比多地区门店：按地区和语言提交同一品牌的商家任务，分析不同市场展示的动态差异。
构建本地 SEO 监测系统：结合 location_code、language_code 和 depth，持续跟踪重点门店的搜索展示，为本地 SEO 优化提供依据。
触发自动化分析： postback_url 或 pingback_url，在任务完成后自动触发分类、提取或竞争对手分析流程。
业务对象：通过 tag 绑定门店 ID、项目编号或客户编号，降低异步任务结果回传后的匹成本。

设置 Google 商家动态任务 ​

计费与请求限制 ​

请求参数 ​

地区参数说明 ​

语言参数说明 ​

请求示例 ​

curl ​

Python ​

TypeScript ​

响应结构 ​

tasks 数组字段 ​

响应示例 ​

状态码与错误处理 ​

实用场景 ​