Business Data API 概览

GET /v3/appendix/user_data

Business Data API 用于获取企业实体可用的数据企业评价、企业信息及商业列表数据。

目前支持以下数据来源和模块：

• Google：/v3/business_data/google/overview/
• Trustpilot：/v3/business_data/trustpilot/overview/
• Tripadvisor：/v3/business_data/tripadvisor/overview/
• 社交媒体：/v3/business_data/social_media/overview/
• Business Listings：基于企业列表数据库提供接口。

本平台将持续扩展 Business Data API 支持的数据来源。

数据获取方式

Business Data API 支持 Live 和 Standard 两种数据获取方式。

Live

Live 方式无需分别调用任务创建接口和结果获取接口，适合需要即时返回结果的业务系统。

请求提交后，接口会直接返回当前任务的处理结果或处理状态。

Standard

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

1. 通过 POST 接口提交任务；
2. 通过 GET 接口获取任务结果。

任务提交后，系统会在完成数据采集和处理后生成结果。你也可以在创建任务时指定以下回调地址：

• pingback_url：任务完成后通知指定地址；
• postback_url：任务完成后将任务结果发送到指定地址。

如果未设置 pingback_url 或 postback_url，可以通过 Tasks Ready 接口获取所有已完成但尚未领取的任务 ID，再通过 Task GET 接口获取对应结果。

请求频率限制

平台限流以认证说明中的 30/60/120 次/分钟规则为准**。如需提高调用频率限制，请联系平台支持团队。

费用与计费

Business Data API 的费用根据接口和返回数据类型计算。

扣费以响应头 X-SeerMarTech-Charge-CNY 为准。你也可以通过以下方式查询账户消耗：

• 在账户控制台查看余额和消费记录；
• 调用 User Data 接口查询账户数据。

通用认证示例

curl --request GET \
  --url https://api.seermartech.cn/v3/appendix/user_data \
  --header 'Authorization: Bearer smt_live_YOUR_KEY'

通用任务处理流程

Live 方式

curl --request POST \
  --url https://api.seermartech.cn/v3/business_data/google/overview \
  --header 'Authorization: Bearer smt_live_YOUR_KEY' \
  --header 'Content-Type: application/json' \
  --data '[
    {
      "keyword": "示例企业名称",
      "location_code": 9999
    }
  ]'

Live 接口通常会直接返回结果或处理状态，请求参数和响应字段请以对应数据源的接口文档为准。

Standard 方式

创建任务时，请使用 JSON 数组作为请求体：

curl --request POST \
  --url https://api.seermartech.cn/v3/business_data/google/overview/task_post \
  --header 'Authorization: Bearer smt_live_YOUR_KEY' \
  --header 'Content-Type: application/json' \
  --data '[
    {
      "keyword": "示例企业名称",
      "location_code": 9999
    }
  ]'

任务创建成功后，可按以下方式处理：

1. 保存响应中的任务 id；
2. 等任务完成；
3. 调用 Tasks Ready 接口获取已完成任务列表，或使用回调地址接收通知；
4. 调用对应的 Task GET 接口获取任务结果。

不同数据源的任务创建、任务查询和结果字段可能有所不同，请以对应接口定义为准。

模块

模块	容路径	数据
Google	/v3/business_data/google/overview/	Google 企业信息及评价
Trustpilot	/v3/business_data/trustpilot/overview/	Trustpilot 企业评价和信息
Tripadvisor	/v3/business_data/tripadvisor/overview/	Tripadvisor 企业评价和信息
社交媒体	/v3/business_data/social_media/overview/	企业在社交媒体平台上的数据
Business Listings	/v3/business_data/business_listings/overview/	企业列表及商业目录数据
企业列表数据库	/v3/databases/business_listings/	企业列表数据库能力

实用场景

• 汇总企业评价：集中采集 Google、Trustpilot 和 Tripadvisor 等平台的评价数据，支持品牌口碑监测和客户满意度分析。
• 比较竞品线上声誉：对多个企业的评分、评价数量和信息进行横向对比，为竞品研究和市场定位提供依据。
• 监测门店与企业信息：定期获取企业资料和商业列表信息，发现地址、联系方式或营业状态变化。
• 构建本地 SEO 数据集：收集目标区域的企业列表和平台信息，用于本地搜索排名分析、门店覆盖评估和目录一致性检查。
• 触发自动化业务流程：通过 pingback_url 或 postback_url 接收任务完成通知，自动更新报表、预警系统或客户数据平台。