主题
商家名录数据库
概述
商家名录数据库收录了数百万条点（POI）记录。每条记录企业主体的信息，例如：
- 服务描述
- 地址及地理位置
- 联系电话
- 官网与域名
- 评分与评论分布
- 营业时间
- 热门时段
该数据库支持 JSON 和 CSV 两种格式。
可下载：
- 数据样例：参考文档
- 支持的地点列表（CSV，最近更新时间 2026-04-06）：参考文档
计费说明
该数据库的费用取决于数据的规模及参数。
由于原文未提供固定单价，因此无法换算统一参考价。扣费以响应头 X-SeerMarTech-Charge-CNY 为准。
字段说明
下表说明数据库中各字段的含义。
| 字段名 | 类型 | 说明 |
|---|---|---|
title | string | 搜索结果中的标题，即商家名称 |
original_title | string | 搜索结果中的原始标题，未经过平台翻译 |
description | string | 搜索结果中的描述信息，即商家简介 |
category | string | 商家主类别，用于概括提供的服务 |
category_ids | array | 局类别 ID；该类目 ID 不随国家变化 |
additional_categories | array | 补类别，用于更细致地描述商家服务 |
cid | string | 地方商家的唯一客户端 ID，可用于合 /v3/reviews/google/overview/ 接口获取完整评论 |
feature_id | string | 搜索结果的唯一标识 |
address | string | 商家完整地址 |
address_info | object | 地址拆分信息对象 |
borough | string | 商家所在行政区或区域 |
address | string | 街道地址 |
city | string | 城市名称 |
zip | string | 邮政编码 |
region | string | 区域信息 |
country_code | string | 商家所在地的 ISO 国家代码 |
place_id | string | 地点唯一标识，可对应 Google Places 的 place id |
phone | string | 商家联系电话 |
url | string | 商家主页绝对 URL |
domain | string | 商家域名 |
logo | string | 商家资料中的 Logo 图片地址 |
main_image | string | 商家资料中的主图地址 |
total_photos | integer | 商家资料中的图片总数 |
snippet | string | 商家的补摘要信息 |
latitude | float | 商家在地图中的纬度坐标 |
longitude | float | 商家在地图中的经度坐标 |
is_claimed | boolean | 是否已由商家所有认领/验证 |
attributes | object | 服务属性信息，通常以勾选项形式展示，并基于用户反馈及商家类别生成 |
available_attributes | object | 可提供的属性 |
unavailable_attributes | object | 不可提供的属性 |
place_topics | object | 评论中提及的及对应提及次数 |
rating | object | 商家评分对象 |
rating_type | string | 评分类型，可为 Max5、Percents、CustomMax |
value | integer / float | 评分值 |
votes_count | integer | 评论/反馈数量 |
rating_max | integer | 当前 rating_type 的最大评分值 |
rating_distribution | object | 评分分布对象 |
1 | integer | 1 星评分数量 |
2 | integer | 2 星评分数量 |
3 | integer | 3 星评分数量 |
4 | integer | 4 星评分数量 |
5 | integer | 5 星评分数量 |
people_also_search | array | 商家列表 |
people_also_search[].cid | string | 商家的客户端 ID |
people_also_search[].feature_id | string | 商家的唯一结果标识 |
people_also_search[].title | string | 商家名称 |
people_also_search[].rating | object | 商家的评分对象 |
people_also_search[].rating_type | string | 评分类型 |
people_also_search[].value | integer / float | 评分值 |
people_also_search[].votes_count | integer | 评论数量 |
people_also_search[].rating_max | integer | 最大评分值 |
work_time | object | 营业时间信息 |
work_hours | object | 营业时段 |
timetable | object | 各星期的营业时间表 |
sunday | array | 周日营业时间；星期字段同理 |
open | object | 开始营业时间 |
hour | integer | 小时，24 小时制 |
minute | integer | 分钟 |
close | object | 结束营业时间 |
current_status | string | 当前营业状态，可为 open、close、temporarily_closed、closed_forever |
popular_times | object | 热门时段信息 |
popular_times_by_days | object | 按星期划分的热门时段 |
time | object | 热门时段时间点 |
popular_index | integer | 热度指数，范围 0 到 100，值越高表示越繁忙 |
local_business_links | array | 可直接与商家交互的链接列表 |
type | string | 交互类型，例如 reservation、order、menu |
title | string | 素标题，通常为对应服务域名或名称 |
url | string | 对应操作链接，如预订、下单、查看菜单 |
delivery_services | array | 可用服务列表 |
contacts | array | 商家的可用联系方式列表 |
contacts[].type | string | 联系方式类型 |
contacts[].value | string | 联系方式 |
contacts[].source | string | 联系方式来源 |
time_update | string | 商家数据最后更新时间，格式为 ISO 8601：YYYY-MM-DDThh:mm:ss |
check_url | string | 指向搜索引擎结果的直达链接，可用于校验结果准确性 |
price_level | string | 价格等级，可为 inexpensive、moderate、expensive、very_expensive；无信息时为 null |
hotel_rating | integer | 店星级，范围 1–5；无信息时为 null |
first_seen | string | 本平台首次发现该商家名录的时间 |
数据结构示例（JSON）
JSON 数据结构示例如下：
json
{
"title": "Lombardo’s Sicilian Pizza",
"original_title": null,
"description": "At Lombardo’s, we’ve been using the same family recipe and making our pizzas the same way since 1957. We’re old school for a reason: our pizza tastes better! We make our unique sauce fresh every day, and every Lombardo’s pizza crust is hand rolled, fresh to order, made with a bit more yeast and sugar to cook up quickly with a soft, flavorful inside and a crispy crunch on the bottom. Once you’ve tried Lombardo’s Pizza, it’s sure to become your favorite pizza on the Lakeshore – or anywhere else!",
"category": "Pizza delivery",
"category_ids": [],
"additional_categories": [],
"cid": "2412308833485550683",
"feature_id": "0x881bd66f3e7b5351:0x217a3e1a6471745b",
"address": "1697 W Sherman Blvd, Muskegon, MI 49441",
"address_info": {
"borough": "Glenside",
"address": "1697 W Sherman Blvd",
"city": "Muskegon",
"zip": "49441",
"region": "Michigan",
"country_code": "US"
},
"place_id": "ChIJUVN7Pm_WG4gRW3RxZBo-eiE",
"phone": "+1231-755-8111",
"url": "http://lombardosmuskegon.com/",
"domain": "lombardosmuskegon.com",
"logo": "https://lh5.googleusercontent.com/-V0ln3Z6x3GU/AAAAAAAAAAI/AAAAAAAAAAA/uCt8jeorXhE/s44-p-k-no-ns-nd/photo.jpg",
"main_image": "https://lh5.googleusercontent.com/p/AF1QipO78Xt03XigMUOYDj4DfXL7D3XhU-WRrS-ACAk2=w426-h240-k-no",
"total_photos": 50,
"snippet": "1697 W Sherman Blvd, Muskegon, MI 49441",
"latitude": 43.205452799999996,
"longitude": -86.2853444,
"is_claimed": true,
"attributes": {
"available_attributes": {
"service_options": [],
"accessibility": []
},
"unavailable_attributes": null
},
"place_topics": {
"price": 22,
"stromboli": 16,
"sub": 10,
"lunch": 19,
"business": 9,
"pie": 6,
"bacon": 5,
"pickle pizza": 4,
"area": 4,
"hands": 5
},
"rating": {
"rating_type": "Max5",
"value": 4.5,
"votes_count": 279,
"rating_max": null
},
"rating_distribution": {
"1": 12,
"2": 9,
"3": 11,
"4": 32,
"5": 215
},
"people_also_search": [],
"work_time": {
"work_hours": {
"timetable": {
"sunday": [],
"monday": [],
"tuesday": [],
"wednesday": [],
"thursday": [],
"friday": [],
"saturday": []
},
"current_status": "close"
}
},
"popular_times": {
"popular_times_by_days": {
"sunday": [],
"monday": [],
"tuesday": [],
"wednesday": [],
"thursday": [],
"friday": [],
"saturday": []
}
},
"local_business_links": [],
"contacts": [],
"time_update": "2023-02-15T12:50:30",
"check_url": "https://www.google.com/maps?cid=2412308833485550683&hl=en&gl=US",
"price_level": "inexpensive",
"hotel_rating": null,
"first_seen": "2024-08-11T08:38:35"
}数据说明补
地址对象 address_info
address_info 用于提供结构化地址信息，便于做地域拆分、城市聚合、门店地图展示或区域筛选。
常见字段：
borough：行政区/街区address：街道地址city：城市zip：邮编region：区域/州/省country_code：ISO 国家代码
评分对象 rating
rating 表示商家在搜索结果中的评分信息：
rating_type：评分类型value：评分值votes_count：评论数rating_max：最大评分值某些评分类型下返回
营业时间 work_time
营业时间数据适合用于门店运营洞察、本地商家可视化或竞争对手营业覆盖分析。
timetable：每周各天的营业时间段current_status：当前营业状态
热门时段 popular_times
popular_times 反映商家在不同日期和时段的客流热度：
popular_times_by_days：按星期返回的热度分布popular_index：0–100 的相对热度指数
商家交互链接 local_business_links
该字段展示可直接与商家互动的，例如：
reservation：预订order：下单menu：菜单
适合用于餐饮、、本地生活等行业的数据整理与功能映射。
认证说明
访问本平台接口时，统一使用 Bearer Token 认证：
http
Authorization: Bearer smt_live_YOUR_KEY示例代码
以下示例演示如何请求本平台 API。若你已获取该数据库文件或对应下载任务信息，可按业务接。
cURL
bash
curl -X GET "https://api.seermartech.cn/v3/" \
-H "Authorization: Bearer smt_live_YOUR_KEY"Python
python
import requests
url = "https://api.seermartech.cn/v3/"
headers = {
"Authorization": "Bearer smt_live_YOUR_KEY"
}
# 示例：按数据库下载或查询场景调用对应接口
response = requests.get(url, headers=headers)
print(response.status_code)
print(response.text)TypeScript
typescript
const response = await fetch("https://api.seermartech.cn/v3/", {
method: "GET",
headers: {
"Authorization": "Bearer smt_live_YOUR_KEY"
}
});
// 示例：按数据库下载或查询场景调用对应接口
const text = await response.text;
console.log(response.status, text);注意事项
- 该页面描述的是数据库结构，并非单一任务型接口。
- 若需按地点、国家或条件筛选数据，请结合购买或下载方式使用。
cid、feature_id、place_id均可用于后续本地商家数据。check_url可用于人工抽样核验结果是否与原始搜索结果一致。- 部分字段可能为
null或空数组，取决于商家是否展示对应信息。
实用场景
- 筛选本地潜在客户：按行业、城市、评分、是否认领等条件筛选商家名单，用于本地获客、销售线索挖掘和渠道拓展。
- 监控竞品门店表现：分析竞品的评分、评论量、营业状态、热门时段和服务属性，识别区域竞争强弱与运营机会。
- 构建门店地图与商圈分析：基于经纬度、地址结构和类别信息绘制门店分布，评估区域覆盖、商圈密度和选址价值。
- 提炼用户点：利用
place_topics和评分分布识别用户频繁提及的产品、服务和问题，为口碑优化与策略提供依据。 - 识别转化缺失：检查商家是否备预订、下单、菜单、联系方式等交互，评估本地搜索结果页的转化能力与优化空间。