获取 Google 商家信息任务结果

本接口用于根据任务 id 获取 Google 商家信息（Google Business Profile）任务结果。返回目标商家的资料，例如服务描述、地址、联系电话、官网域名、评分、营业时间、热门时段、可预订/下单链接、目录以及服务项目等信息。

接口说明

请求方式：GET
请求地址：https://api.seermartech.cn/v3/business_data/google/my_business_info/task_get/$id

计费说明

该接口本身不会重复收费，在创建任务时扣费；任务创建后，可在 30 天多次按 id 获取结果。

由于平台按任务提交收费，此接口返回中的 cost 通常为 0。 扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

路径参数

字段	类型	说明
`id`	string	任务唯一标识，UUID 格式。任务创建后，可在 30 天随时使用该 `id` 获取结果。

响应结构

接口返回 JSON 对象，顶层 tasks 数组，每个任务对应一个结果对象。

顶层字段

字段	类型	说明
`version`	string	当前 API 版本
`status_code`	integer	接口通用状态码
`status_message`	string	接口通用状态信息
`time`	string	执行耗时，单位秒
`cost`	float	本次返回涉及的总任务成本，单位 USD
`tasks_count`	integer	`tasks` 数组中的任务数量
`tasks_error`	integer	返回错误的任务数量
`tasks`	array	任务结果数组

建议对 status_code 和任务级别的 status_code 做完整异常处理。

`tasks[]` 字段

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

`tasks[].result[]` 字段

字段	类型	说明
`keyword`	string	创建任务时提交的。若使用了 `cid` 查询，这里会返回如 `cid:2946633002421908862` 的值。返回时会对 `%##` 做解码，`+` 会被解码为空格。
`se_domain`	string	创建任务时指定的搜索引擎域名
`location_code`	integer	创建任务时指定的位置编码
`language_code`	string	创建任务时指定的语言编码
`check_url`	string	结果校验链接，可直接打开验证结果准确性
`datetime`	string	结果抓取时间，UTC 格式，如 `2019-11-15 12:57:46 +00:00`
`item_types`	array	`items` 中出现的结果类型。当前可能值：`google_business_info`
`items_count`	integer	`items` 数组中的数量
`items`	array	商家信息结果数组

`items[]` 字段说明

基础信息

字段	类型	说明
`type`	string	素类型，固定为 `google_business_info`
`rank_group`	integer	同类型组排名
`rank_absolute`	integer	所有中的绝对排名
`position`	string	在结果页中的展示位置
`title`	string	商家名称
`original_title`	string	原始标题，未经过搜索引擎翻译
`description`	string	商家描述
`category`	string	主类别，描述该商家提供的核心服务
`category_ids`	array	局类别 ID，不随国家变化
`additional_categories`	array	更细分的附加类别

标识符

字段	类型	说明
`cid`	string	商家唯一客户端 ID，可用于评论等本地商家数据
`feature_id`	string	结果在搜索结果中的唯一标识
`place_id`	string	地点唯一标识
`is_claimed`	boolean	是否已由商家所有在地图中认领/验证

联系与地址信息

字段	类型	说明
`address`	string	商家完整地址
`address_info`	object	地址拆分信息
`address_info.borough`	string	行政区/辖区
`address_info.address`	string	街道地址
`address_info.city`	string	城市
`address_info.zip`	string	邮编
`address_info.region`	string	区域
`address_info.country_code`	string	国家 ISO 编码
`phone`	string	联系电话
`url`	string	商家网站完整链接
`contact_url`	string	优联系页面 URL
`contributor_url`	string	本地向导或贡献资料页 URL（如有）
`book_online_url`	string	“在线预订”按钮链接
`domain`	string	商家官网域名

图片与展示信息

字段	类型	说明
`logo`	string	商家资料中的 Logo 图片 URL
`main_image`	string	商家资料中的主图 URL
`total_photos`	integer	商家资料中的图片总数
`snippet`	string	补说明信息

地理坐标

字段	类型	说明
`latitude`	float	纬度，例如 `51.584091`
`longitude`	float	经度，例如 `-0.31365919999999997`

服务属性与评论主题

字段	类型	说明
`attributes`	object	基于用户反馈和商家类别总结出的服务属性
`available_attributes`	object	商家可提供的属性
`unavailable_attributes`	object	商家不提供的属性
`place_topics`	object	评论中高频出现的主题词及提及次数，例如 `{ "egg roll": 48, "birthday": 33 }`

评分信息

字段	类型	说明
`rating`	object	评分对象
`rating.rating_type`	string	评分类型，可能为 `Max5`、`Percents`、`CustomMax`
`rating.value`	integer/float	当前评分值
`rating.votes_count`	integer	评价数量
`rating.rating_max`	integer	评分上限
`rating_distribution`	object	1 星到 5 星的评分分布
`rating_distribution.1`	integer	1 星数量
`rating_distribution.2`	integer	2 星数量
`rating_distribution.3`	integer	3 星数量
`rating_distribution.4`	integer	4 星数量
`rating_distribution.5`	integer	5 星数量

商家

字段	类型	说明
`people_also_search`	array	商家列表
`people_also_search[].cid`	string	商家 `cid`
`people_also_search[].feature_id`	string	商家结果唯一标识
`people_also_search[].title`	string	商家名称
`people_also_search[].rating`	object	商家评分对象
`people_also_search[].rating.rating_type`	string	评分类型
`people_also_search[].rating.value`	integer/float	评分值
`people_also_search[].rating.votes_count`	integer	评价数量
`people_also_search[].rating.rating_max`	integer	评分上限

营业时间

字段	类型	说明
`work_time`	object	营业时间
`work_time.work_hours`	object	营业时段信息
`work_time.work_hours.timetable`	object	每周营业时间表
`work_time.work_hours.timetable.sunday`	array	周日营业时间
`work_time.work_hours.timetable.monday`	array	周一营业时间
`work_time.work_hours.timetable.tuesday`	array	周二营业时间
`work_time.work_hours.timetable.wednesday`	array	周三营业时间
`work_time.work_hours.timetable.thursday`	array	周四营业时间
`work_time.work_hours.timetable.friday`	array	周五营业时间
`work_time.work_hours.timetable.saturday`	array	周营业时间
`open.hour`	integer	开始小时，24 小时制
`open.minute`	integer	开始分钟
`close.hour`	integer	结束小时，24 小时制
`close.minute`	integer	结束分钟
`work_time.current_status`	string	当前营业状态，可为 `opened`、`closed`、`temporarily_closed`、`closed_forever`

字段	类型	说明
`popular_times`	object	热门时段数据
`popular_times.popular_times_by_days`	object	按星期拆分的繁忙时段
`popular_times.popular_times_by_days.sunday`	array	周日繁忙时段
`time.hour`	integer	小时，24 小时制
`time.minute`	integer	分钟
`popular_index`	integer	热度指数，范围 `0-100`，值越高表示越繁忙

可交互业务链接

字段	类型	说明
`local_business_links`	array	可直接与商家交互的链接集合
`local_business_links[].type`	string	类型，可能为 `reservation`、`order`、`menu`
`local_business_links[].title`	string	素标题，通常为服务商域名或名称
`local_business_links[].url`	string	对应操作链接
`delivery_services`	array	外送服务列表
`delivery_services[].type`	string	固定为 `delivery_services_element`
`delivery_services[].title`	string	外送平台名称或域名
`delivery_services[].url`	string	下单链接

字段	类型	说明
`is_directory_item`	boolean	是否属于同址目录中的一个商家
`directory`	array	同地址目录信息
`directory[].title`	string	目录标题，可能为 `At this place` 或 `Directory`
`directory[].items`	array	目录中的商家项目列表

字段	类型	说明
`type`	string	素类型，固定为 `maps_search`
`rank_group`	integer	同类型组排名
`rank_absolute`	integer	绝对排名
`domain`	string	商家域名
`title`	string	商家名称
`url`	string	商家完整链接
`rating`	object	商家评分
`rating_distribution`	object	评分分布
`snippet`	string	商家补信息
`address`	string	商家地址
`address_info`	object	地址拆分信息
`place_id`	string	地点唯一标识
`phone`	string	电话
`main_image`	string	主图
`total_photos`	integer	图片总数
`category`	string	主类别
`category_ids`	array	局类别 ID
`work_hours`	object	营业时间
`feature_id`	string	唯一结果标识
`cid`	string	商家 `cid`
`latitude`	float	纬度
`longitude`	float	经度
`is_claimed`	boolean	是否已认领
`local_justifications`	array	本地展示理由文本
`is_directory_item`	boolean	是否属于目录项
`price_level`	string	价格级别，可为 `inexpensive`、`moderate`、`expensive`、`very_expensive`
`hotel_rating`	integer	店星级，范围 `1-5`，无数据时为 `null`

服务项目

字段	类型	说明
`services`	array	商家提供的服务列表
`services[].category`	string	服务分类，例如 `Internet Marketing Service`
`services[].title`	string	服务标题
`services[].snippet`	string	商家提供的服务描述
`services[].price`	object	价格信息
`services[].price.current`	float	当前价格
`services[].price.regular`	float	原价
`services[].price.max_value`	float	未折扣的最高价格
`services[].price.currency`	string	货币代码，ISO 4217 格式
`services[].price.is_price_range`	boolean	是否为价格区间
`services[].price.displayed_price`	string	页面展示的价格文案

沙箱测试

可使用以下沙箱地址获取完整字段结构的模拟结果，调用沙箱不会扣费：

https://api.seermartech.cn/v3/business_data/google/my_business_info/task_get/00000000-0000-0000-0000-000000000000

请求示例

cURL

bash

id="09171517-0696-0242-0000-a96bc1ad0bce"

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

Python

python

import requests

task_id = "02231934-2604-0066-2000-570459f04879"
url = f"https://api.seermartech.cn/v3/business_data/google/my_business_info/task_get/{task_id}"

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

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

TypeScript

typescript

import axios from "axios";

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

axios({
 method: "get",
 url: `https://api.seermartech.cn/v3/business_data/google/my_business_info/task_get/${taskId}`,
 headers: {
 Authorization: "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
 }
})
 .then((response) => {
 // 输出结果数据
 console.log(response.data);
 })
 .catch((error) => {
 console.error(error);
 });

结果获取方式补

接中，通常通过以下接口获取已完成任务列表：

GET /v3/business_data/google/my_business_info/tasks_ready

然后再使用返回的任务 id 或完整 endpoint 调用：

GET /v3/business_data/google/my_business_info/task_get/$id

这适合批量轮询并抓取已完成的商家信息任务结果。

响应示例

json

{
 "version": "0.1.20230705",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.0776 sec.",
 "cost": 0,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "se_type": "business_info",
 "se": "google",
 "api": "business_data",
 "function": "my_business_info",
 "language_code": "en",
 "location_name": "Toronto,Ontario,Canada",
 "keyword": "cid:7116580480031320180",
 "device": "desktop",
 "os": "windows"
 },
 "result": [
 {
 "items_count": 1,
 "items": [
 {
 "title": "示例商家",
 "feature_id": "0x882b2d67af2a8289:0x2c6f7eefcc1adf96",
 "cid": "3201917428470308758",
 "latitude": 43.7632353,
 "longitude": -79.4057069,
 "is_claimed": true,
 "is_directory_item": true,
 "price_level": "expensive",
 "hotel_rating": null,
 "services": []
 }
 ]
 }
 ]
 }
 ]
}

状态码与错误处理

顶层 status_code = 20000 表示请求成功
任务级别 tasks[].status_code 用于判断单个任务是否成功
若 tasks[].status_code >= 40000，通常表示该任务执行失败或无结果
建议同时检查：
顶层 status_code
tasks_error
tasks[].status_code
tasks[].result 是否为空

使用建议

调用创建任务接口提交商家信息查询任务。
通过 /v3/business_data/google/my_business_info/tasks_ready 轮询已完成任务。
使用本接口按 id 获取详细结果。
如需验证抓取准确性，可使用返回的 check_url 人工核查。
如需复用商家标识做后续分析，优保存 cid、feature_id、place_id。

实用场景

拉取门店档案：获取单个门店的名称、地址、电话、官网、营业时间等基础资料，用于构建本地商家数据库。
监测品牌门店信息一致性：比对不同地区门店的分类、联系方式、营业时间与官网链接，及时发现资料缺失或错误。
分析用户点：利用 place_topics、评分分布和服务属性识别用户评论中的高频主题，优化门店服务与口碑运营。
挖掘同址竞争：通过 directory 和 people_also_search 识别同地址商户与商家，用于本地竞争分析和选址评估。
提取转化：抓取 book_online_url、local_business_links、delivery_services 等字段，分析商家在本地搜索中的预约、点单和菜单转化路径。

获取 Google 商家信息任务结果 ​

接口说明 ​

计费说明 ​

路径参数 ​

响应结构 ​

顶层字段 ​

tasks[] 字段 ​

tasks[].result[] 字段 ​

items[] 字段说明 ​

基础信息 ​

标识符 ​

联系与地址信息 ​

图片与展示信息 ​

地理坐标 ​

服务属性与评论主题 ​

评分信息 ​

商家 ​

营业时间 ​

热门时段 ​

可交互业务链接 ​

目录 ​

directory[].items[] 字段 ​

服务项目 ​

沙箱测试 ​

请求示例 ​

cURL ​

Python ​

TypeScript ​

结果获取方式补 ​

响应示例 ​

状态码与错误处理 ​

使用建议 ​