商业数据 API：概览

商业数据 API 用于获取任意商业实体的可用数据。

当前，本接口主要基于以下平台的数据源提供能力：

Google
Trustpilot
Tripadvisor
社交媒体， Pinterest 与 Reddit

此外，商业数据 API 还 Business Listings 端点，可用于查询商业名录数据。

本平台会持续扩展商业数据 API 可用的数据源范围，以支持更丰富的企业信息、口碑评价与平台分析需求。

支持的数据获取方式

商业数据 API 支持两种任务获取方式：Live 和 Standard。

Live 方法

Live 方法无需分别发起 POST 与 GET 请求，适合需要即时返回结果的业务场景。

特点：

单次请求即可创建任务并直接获取结果
适合实时查询、前台页面即时展示、快速分析等场景
可减少任务轮询与异步处理逻辑

Standard 方法

Standard 方法需要分两步完成数据获取：

通过对应端点的 POST 请求创建任务
再通过对应端点的 GET 请求获取结果

使用 Standard 方法时，结果会在本平台完成数据采集后返回，适合批量任务、异步处理、低耦合集成等场景。

回调通知

在创建任务时，你可以指定以下参数：

pingback_url：任务完成后通知你的系统
postback_url：任务完成后将结果直接推送到你的系统

如果未设置 pingback_url 或 postback_url，你可以通过 Tasks Ready 端点获取所有已完成但尚未被领取的任务 id 列表，然后再使用对应的 Task GET 端点获取结果。

这种机制适合：

批量任务的统一回收
降低主动轮询次数
与异步任务队列合使用

请求频率限制

商业数据 API 的默认频率限制为：

每分钟最多 2000 次 API 调用

如需提高调用上限，可联系本平台申请调整。

费用与优级

该页为概览页，未提供端点单价。费用取决于所调用的接口、任务类型与返回数据量。

请注意：

实扣费以响应头 X-SeerMarTech-Charge-CNY 为准
可通过用户数据接口查询账户余额、消费与额信息
不同端点、不同方法（Live / Standard）可能对应不同计费方式

认证方式

调用接口时，请在请求头中使用 Bearer Token 认证：

bash

Authorization: Bearer smt_live_YOUR_KEY

通用请求说明

当某个端点使用 POST 创建任务时，请求体应使用 JSON 数组格式：

json

[
 {
 "pingback_url": "https://your-server.com/pingback",
 "postback_url": "https://your-server.com/postback"
 }
]

接口分类

以下是商业数据 API 当前覆盖的主要数据方向：

1. 平台商家信息与评价数据

支持从平台获取企业实体的：

商家基础信息
用户评分
评论
评论数量
平台口碑表现

适用于品牌监测、门店分析、竞品口碑研究等业务。

2. 社交媒体数据

支持分析社交平台中的提及与：

社媒
平台讨论热度
提及
社区口碑与趋势线索

3. 商业名录数据

支持查询商业名录与企业列表类信息，用于：

企业发现
本地商户拓展
行业名单构建
线索挖掘

型调用方式

不同子端点的路径、参数与响应结构会有所不同，但整体调用模式通常遵循以下形式。

Live 请求示例

bash

curl --request POST \
 --url https://api.seermartech.cn/v3/business_data/google/live \
 --header 'Authorization: Bearer smt_live_YOUR_KEY' \
 --header 'Content-Type: application/json' \
 --data '[
 {
 "keyword": "coffee shop"
 }
 ]'

Python 示例

python

import requests

url = "https://api.seermartech.cn/v3/business_data/google/live"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}
data = [
 {
 "keyword": "coffee shop"
 }
]

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

TypeScript 示例

typescript

const url = 'https://api.seermartech.cn/v3/business_data/google/live';

const response = await fetch(url, {
 method: 'POST',
 headers: {
 'Authorization': 'Bearer smt_live_YOUR_KEY',
 'Content-Type': 'application/json',
 },
 body: JSON.stringify([
 {
 keyword: 'coffee shop',
 },
 ]),
});

const data = await response.json;
console.log(data);

通用响应说明

不同端点返回的字段会有所差异，但通常会以下通用信息：

字段	类型	说明
`id`	string	任务唯一标识
`status_code`	integer	任务或请求状态码
`status_message`	string	状态描述
`cost`	number	本次请求扣费
`result_count`	integer	返回结果数量
`path`	array	当前调用的接口路径
`data`	object	请求参数回显
`result`	array	结果数据

通用错误处理

如调用失败，通常可从响应中的状态信息判断原因。建议重点以下：

字段	说明
`status_code`	错误或状态代码
`status_message`	错误说明

常见问题通常：

认证失败：Bearer Token 无效或缺失
参数错误：请求体格式不正确，或缺少填字段
任务不存在：使用错误的任务 id 获取结果
频率限：每分钟请求上限
平台数据暂不可用：目标平台响应异常或数据源受限

使用建议

为提升接效率，建议按以下方式设计调用流程：

实时查询场景：优使用 Live 方法
批量采集场景：优使用 Standard 方法
高并发异步场景：结合 postback_url 或 pingback_url
统一结果回收场景：使用 Tasks Ready + Task GET 模式
成本控制场景：记录并汇总每次响应中的 cost 字段

实用场景

监测门店口碑：抓取评分与评论数据，持续跟踪门店服务表现，本地运营优化。
分析竞品评价：对比不同品牌在评论量、评分和用户反馈上的差异，为市场定位与产品改进提供依据。
挖掘本地商户线索：基于商业名录与平台信息批量发现目标企业，提高销售拓客效率。
追踪社媒讨论：识别企业或品牌在社交平台中的提及，及时发现舆变化与机会。
构建企业画像：整合商家基础信息、用户评价与平台数据，形成可用于选址、投资或合作评估的业务画像。

商业数据 API：概览 ​

支持的数据获取方式 ​

Live 方法 ​

Standard 方法 ​

回调通知 ​

请求频率限制 ​

费用与优级 ​

认证方式 ​

通用请求说明 ​

接口分类 ​

1. 平台商家信息与评价数据 ​

2. 社交媒体数据 ​

3. 商业名录数据 ​

型调用方式 ​

Live 请求示例 ​

Python 示例 ​

TypeScript 示例 ​

通用响应说明 ​

通用错误处理 ​

使用建议 ​

实用场景 ​