SeerMarTech API 文档

主题

创建 Google 商家信息任务 ​

POST /v3/business_data/google/my_business_info/task_post

接口说明 ​

该接口用于提交 Google 商家信息采集任务，返回指定商家实体在 Google 中的基础信息结果。获取结果会受到所选地理位置与语言的影响。

  • 请求方式：POST
  • 接口地址：https://api.seermartech.cn/v3/business_data/google/my_business_info/task_post

你可以通过以下任一方式指定查询地域：

  • location_name
  • location_code
  • location_coordinate

你也可以通过以下任一方式指定语言：

  • language_name
  • language_code

任务创建成功后，可通过返回的唯一任务 ID id 获取结果；也可以在创建任务时指定 postback_url 或 pingback_url，由本平台在任务完成后主动通知或回传结果。

计费与限制 ​

创建任务即会产生费用。

  • 参考价约 ¥0.0240 / 次
  • 实扣费以响应头 X-SeerMarTech-Charge-CNY 为准
  • 高优级任务会额外收费

并发与请求限制：

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

回调说明 ​

如果在创建任务时传 postback_url 或 pingback_url：

  • postback_url：任务完成后，本平台会向该地址发送 POST 请求，并以 gzip 压缩格式传输结果
  • pingback_url：任务完成后，本平台会向该地址发送 GET 通知请求

支持使用以下变量：

  • $id：任务 ID
  • $tag：URL 编码后的任务标签

示例：

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

注意事项：

  • postback_url 与 pingback_url 中的特殊字符会被 URL 编码
  • 例如 # 会被编码为 %23
  • 如果你的服务端 10 秒未响应，连接会因时中断，任务会转 /v3/business_data/google/my_business_info/tasks_ready/ 列表，后续可自行获取结果
  • 错误码和错误信息会因你的服务器而不同

请求体格式 ​

所有 POST 数据使用 JSON（UTF-8 编码），并数组形式提交：

json
[
 {
 "location_code": 1023191,
 "language_code": "en",
 "keyword": "RustyBrick, Inc."
 }
]

请求参数 ​

任务级参数 ​

字段名类型填说明
keywordstring是查询，通常应填写本地商家名称。最长 700 个字符。字段中的 %## 会被解码，字符 + 会被解码为空格。如果需要传 %，请写成 %25。该字段也支持直接传商家标识：cid 或 place_id。示例：cid:194604053573767737、place_id:GhIJQWDl0CIeQUARxks3icF8U8A
priorityinteger否任务优级。可选值：1 = 普通优级（默认），2 = 高优级。高优级会额外计费。
location_namestring条件填搜索引擎位置完整名称。当未提供 location_code 或 location_coordinate 时填。使用该字段时，无需再传 location_code 或 location_coordinate。示例：London,England,United Kingdom
location_codeinteger条件填搜索引擎位置代码。当未提供 location_name 或 location_coordinate 时填。使用该字段时，无需再传 location_name 或 location_coordinate。示例：2840
location_coordinatestring条件填GPS 坐标，格式为 latitude,longitude,radius。当未提供 location_name 或 location_code 时填。纬度和经度最多 7 位小数；radius 最小值为 199.9（mm），最大值为 199999（mm）。示例：53.476225,-2.243572,200
language_namestring条件填搜索语言完整名称。当未提供 language_code 时填。使用该字段时，无需再传 language_code。示例：English
language_codestring条件填搜索语言代码。当未提供 language_name 时填。使用该字段时，无需再传 language_name。示例：en
tagstring否自定义任务标识，最长 255 个字符。可用于结果回传后的任务匹，返回结果中的 data 对象会该值。
postback_urlstring否结果回传地址。任务完成后，本平台会将结果以 POST 方式发送到该地址，数据为 gzip 压缩格式。支持 $id、$tag 变量。
pingback_urlstring否完成通知地址。任务完成后，本平台会以 GET 请求通知该地址。支持 $id、$tag 变量。

地域与语言列表 ​

可通过以下接口获取可用地域与语言：

  • 地域列表：/v3/business_data/google/locations
  • 语言列表：/v3/business_data/google/languages

响应说明 ​

接口返回 JSON 数据，任务提交状态及每个任务的详细信息。

顶层响应字段 ​

字段名类型说明
versionstring当前 API 版本
status_codeinteger通用状态码
status_messagestring通用状态信息
timestring执行耗时，单位：秒
costfloat本次请求总费用，单位通常为平台结算币种；接侧请以该字段为准
tasks_countintegertasks 数组中的任务数量
tasks_errorinteger返回错误的任务数量
tasksarray任务数组

tasks[] 字段 ​

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

建议在接时设计完善的状态码与异常处理机制。

请求示例 ​

cURL ​

bash
curl --location --request POST "https://api.seermartech.cn/v3/business_data/google/my_business_info/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_info/task_post"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}

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"
 }
]

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

TypeScript ​

typescript
import axios from "axios";

const 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"
 }
];

axios({
 method: "post",
 url: "https://api.seermartech.cn/v3/business_data/google/my_business_info/task_post",
 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.20200909",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.0889 sec.",
 "cost": 0.0015,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "api": "business_data",
 "function": "my_business_info",
 "se": "google",
 "language_code": "en",
 "location_name": "New York,New York,United States",
 "keyword": "RustyBrick, Inc.",
 "se_type": "business_info",
 "device": "desktop",
 "os": "windows"
 },
 "result": null
 }
 ]
}

状态码与错误处理 ​

通用状态 ​

状态码含义
20000请求成功
40006单次 POST 请求中的任务数量 100 个，出部分未被接受

处理建议 ​

  • 检查顶层 status_code 是否为 20000
  • 再逐个检查 tasks[].status_code
  • 对 postback_url / pingback_url 回调失败做好重试或补偿拉取
  • 对任务数限制的请求进行拆分
  • 以响应中的 cost 字段作为最终扣费依据

结果获取方式 ​

创建任务后，可通过以下方式获取结果：

  1. 使用返回的 id 轮询结果接口
  2. 使用 postback_url 接收完整结果
  3. 使用 pingback_url 接收完成通知后，再按任务 ID 获取结果
  4. 若回调时失败，可从 /v3/business_data/google/my_business_info/tasks_ready/ 中查询已完成任务

使用要点 ​

  • keyword 建议优填写商家完整名称
  • 如果你已掌握商家唯一标识，建议直接使用 cid: 或 place_id: 提高定位准确性
  • 地域参数三选一：location_name、location_code、location_coordinate
  • 语言参数二选一：language_name、language_code
  • 单次请求建议按批次提交， 100 个任务上限

实用场景 ​

  • 核验门店实体信息：按品牌名、门店名或 place_id 查询商家实体，校验本地商户是否已被正确收录，提升本地 SEO 数据准确性。
  • 批量监控品牌门店收录状态：按城市与语言批量创建任务，跟踪连锁门店在不同地区的商家信息覆盖，区域运营与选址评估。
  • 通过 CID/Place ID 精准匹商家：在已知唯一标识的直接查询目标商家，减少同名商户干扰，提升主数据归档与映射效率。
  • 构建商家信息回流流程：结合 postback_url 或 pingback_url 自动接收任务完成通知，将商家数据同步到 CRM、门店库或 BI 系统。
  • 评估多语言本地展示一致性：切换不同 language_code 与地点，对比同一商家在不同语言环境下的信息呈现差异，支持化本地搜索优化。

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

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