SeerMarTech API 文档

主题

商家列表数据库 ​

商家列表数据库收录数百万条点（POI）记录，涵盖商家的信息服务说明、地址与地理位置、联系电话、网站域名、评分、营业时间、热门时段等数据。

数据库支持 JSON 和 CSV 格式。可获取数据库样本，并下载支持的地区完整列表（CSV；上次更新：2026-09-01）。

计费说明 ​

数据库费用取决于数据库的数据规模及参数。

扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

字段说明 ​

商家基本信息 ​

字段类型说明
titlestring搜索结果中的标题，即商家名称。
original_titlestring | null搜索结果中的原始标题，未经过搜索引擎翻译。
descriptionstring | null商家描述信息。
categorystring | null最能概括商家服务的主商家分类。
category_idsarray局分类 ID 列表，不随所选国家或地区变化。
additional_categoriesarray更详细描述商家服务的附加分类列表。
cidstring本地商家的唯一客户端标识符。可用于 /v3/reviews/google/overview/?php 获取完整评价列表。
feature_idstring搜索结果的唯一标识符。
addressstring | null商家的完整地址。
place_idstring商家地点的唯一地点标识符。
phonestring | null商家联系电话。
urlstring | null商家官网的绝对 URL。
domainstring | null商家网站域名。
logostring | null商家资料页展示的 Logo 图片 URL。
main_imagestring | null商家资料页展示的主图 URL。
total_photosinteger | null商家资料页中的图片总数。
snippetstring | null商家的附加摘要信息。
latitudefloat商家在地图中的纬度坐标。
longitudefloat商家在地图中的经度坐标。
is_claimedboolean | null商家是否已由所有在地图服务中认领或验证。
time_updatestring商家数据最后更新时间，采用 ISO 8601 格式：YYYY-MM-DDThh:mm:ss。例如：2020-09-12T00:07:43。
check_urlstring指向搜索结果的直接链接，可用于核验数据。
price_levelstring | null消费水平，可选值：inexpensive、moderate、expensive、very_expensive。未提供时为 null。
hotel_ratinginteger | null店星级，范围为 1–5。非或无数据时为 null。
first_seenstring本平台首次发现该商家列表的时间。采用 UTC 时间格式：yyyy-mm-dd hh-mm-ss +00:00。例如：2019-11-15 12:57:46 +00:00。

地址信息：address_info ​

address_info 为对象，商家地址的拆分字段。

字段类型说明
address_info.boroughstring | null商家所在的行政区、街区或辖区。
address_info.addressstring | null商家的街道地址。
address_info.citystring | null商家所在城市。
address_info.zipstring | null邮政编码。
address_info.regionstring | null商家所在 DMA 区域或地区。
address_info.country_codestring商家所在国家或地区的 ISO 国家代码。

服务属性：attributes ​

attributes 对象提供基于用户反馈及商家分类的服务能力信息。

字段类型说明
attributes.available_attributesobject | null商家可提供的服务属性，例如服务方式、无障碍设施等。
attributes.unavailable_attributesobject | null商家不提供的服务属性。

评价主题：place_topics ​

place_topics 为对象，客户评价中高频出现的产品、服务或体验，以及提及对应的评价数量。

json
{
  "place_topics": {
    "蛋卷": 48,
    "生日": 33
  }
}

评分信息：rating ​

字段类型说明
rating.rating_typestring评分类型，可为 Max5、Percents 或 CustomMax。
rating.valuenumber当前评分值。
rating.votes_countinteger评价或反馈数量。
rating.rating_maxinteger | null当前评分类型的最高分值。

评分分布：rating_distribution ​

rating_distribution 对象展示用户给出的 1 星至 5 星评价数量。

字段类型说明
rating_distribution.1integer1 星评价数量。
rating_distribution.2integer2 星评价数量。
rating_distribution.3integer3 星评价数量。
rating_distribution.4integer4 星评价数量。
rating_distribution.5integer5 星评价数量。

people_also_search 为数组，列出与当前商家的商家实体。

字段类型说明
people_also_search[].cidstring商家的唯一客户端标识符。
people_also_search[].feature_idstring商家在搜索结果中的唯一标识符。
people_also_search[].titlestring商家名称。
people_also_search[].ratingobject商家的评分信息，字段结构与 rating 相同。

营业时间：work_time ​

字段类型说明
work_time.work_hours.timetableobject按星期组织的营业时间表。
work_time.work_hours.timetable.sundayarray周日营业时段；星期字段为 monday 至 saturday。
work_time.work_hours.timetable.{day}[].open.hourinteger开始营业的小时，24 小时制。
work_time.work_hours.timetable.{day}[].open.minuteinteger开始营业的分钟。
work_time.work_hours.timetable.{day}[].close.hourinteger结束营业的小时，24 小时制。
work_time.work_hours.timetable.{day}[].close.minuteinteger结束营业的分钟。
work_time.work_hours.current_statusstring商家当前状态：open、close、temporarily_closed 或 closed_forever。

popular_times 提供商家在不同日期和时段的繁忙程度信息。

字段类型说明
popular_times.popular_times_by_daysobject按星期划分的热门时段数据。
popular_times.popular_times_by_days.sundayarray周日的繁忙时段；星期字段为 monday 至 saturday。
popular_times.popular_times_by_days.{day}[].time.hourinteger时段小时，24 小时制。
popular_times.popular_times_by_days.{day}[].time.minuteinteger时段分钟。
popular_times.popular_times_by_days.{day}[].popular_indexinteger热门指数，范围为 0–100；数值越高表示该时段越繁忙。

local_business_links 为数组，提供可直接与商家互动的链接。

字段类型说明
local_business_links[].typestring互动类型，可为 reservation、order 或 menu。
local_business_links[].titlestring互动服务名称，通常为预约、在线点餐或菜单服务的平台域名。
local_business_links[].urlstring对应的预约、下单或查看菜单链接。
local_business_links[].delivery_servicesarray可用服务列表，适用于 order 类型。
local_business_links[].delivery_services[].typestring送服务类型，固定为 delivery_services_element。
local_business_links[].delivery_services[].titlestring在线点餐系统或服务名称。
local_business_links[].delivery_services[].urlstring对应或下单链接。

联系方式：contacts ​

字段类型说明
contactsarray商家的可用联系信息列表。
contacts[].typestring联系方式类型。
contacts[].valuestring联系方式。
contacts[].sourcestring联系方式的数据来源。

JSON 数据示例 ​

以下示例展示单条商家记录的型 JSON 结构。部分数组或对象字段会因商家信息缺失而返回空数组、null 或省略。

json
{
  "title": "Lombardo’s Sicilian Pizza",
  "original_title": null,
  "description": "一家提供披萨服务的本地餐。",
  "category": "披萨",
  "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://example.com/logo.jpg",
  "main_image": "https://example.com/main-image.jpg",
  "total_photos": 50,
  "snippet": "1697 W Sherman Blvd, Muskegon, MI 49441",
  "latitude": 43.2054528,
  "longitude": -86.2853444,
  "is_claimed": true,
  "attributes": {
    "available_attributes": {
      "service_options": [],
      "accessibility": []
    },
    "unavailable_attributes": null
  },
  "place_topics": {
    "价格": 22,
    "午餐": 19,
    "培根": 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"
}

实用场景 ​

  • 构建本地商家名录：按国家、城市、分类及地理坐标筛选商家，快速搭建垂直行业黄页或区域商家数据库。
  • 评估门店竞争格局：结合商家分类、评分、评价数量和商家，识别目标区域的主要竞争对手。
  • 筛选潜在客户线索：通过行业分类、官网域名、电话、地址及商家认领状态，生成适用于本地营销服务的销售线索。
  • 分析商圈客流时段：利用 popular_times 和营业时间数据判断高峰时段，为广告投放、排班与到店活动提供依据。
  • 监控品牌门店信息完整度：核对地址、电话、网站、图片、营业时间及评价状态，发现连锁门店在本地搜索中的信息缺失或异常。

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

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