点评口碑 · 数据 API

谷歌地图点评

谷歌地图点评 API

先搜索 Google Maps 地点并核对分店,再读取营业资料、顾客评价与商家回复,供门店资料核验和口碑问题整理使用。 调用 POST /api/v1/social ;返回结构化 JSON,$1.39 / 千次;失败不计费。

3

个能力

$1.39 / 千次

能力价格

同步

调用模式

1 个

一把 Key 通用 89 个平台

谷歌地图点评 能力清单

action必填参数可选参数单次条数模式单价返回字段
searchkeywordcountry, language, location默认 15 · 最多 50同步$1.39 / 千次place_id · name · url · category · categories · description · address · city · state · postal_code · country_code · lat · lng · phone · website · rating · rating_scale · review_count · price · permanently_closed · image_url · platform
profileurlcity, language, since, sort—同步$1.39 / 千次place_id · name · url · category · categories · description · address · neighborhood · city · state · postal_code · country_code · plus_code · lat · lng · phone · website · rating · rating_scale · review_count · image_count · price · permanently_closed · temporarily_closed · opening_hours · image_url · platform
reviewsurllang, language, since, sort默认 20 · 最多 100同步$1.39 / 千次id · text · rating · rating_scale · reviewer_name · reviewer_review_count · is_local_guide · like_count · posted_at · url · owner_response · owner_response_at · detailed_rating · image_urls · place_id · place_name · platform

谷歌地图点评 每个接口分别做什么

下面逐个解释 action、必填参数、可选筛选项和允许值。 请求都发到 POST /api/v1/social, 切换 action 时,也要按对应接口调整参数。 同名参数在不同平台、不同接口中可能指向不同对象;请以该条说明中的格式和适用范围为准。

下方只展示平台官方资料,用于核对对象与术语,不表示平台对 EveryInfra 的授权或背书。 本接口接受的参数、字段与能力边界以各条说明为准,不与平台官方 API 直接等同。

怎么调用 谷歌地图点评 主页或对象详情 API?

profile

使用 platform="google_maps_reviews"、action="profile" 调用“主页或对象详情”能力;返回单个对象,主要包含 place_id、name、url、category、categories、description 等 27 个字段。

谷歌地图点评 profile 的参数分别是什么意思?

url必填
Google Maps 地点完整链接,优先使用搜索结果中保留 query_place_id 的 URL;仅有店名与地图坐标的 /place/ 链接可能无法稳定定位同一家店。profile 查商户资料,reviews 查该商户评论。

Google Maps 链接可用 query_place_id 定位具体地点,而不只依赖地点名称或坐标。官方来源:Google Maps:地点链接与 Place ID来源核查:

city可选
地点查询中的城市约束文本;当前精确 URL 的 profile 也公开此参数,但不能用它把同一商户移到另一城市或保证替代 URL 定位。
language可选
查询/页面内容语言,默认 en。reviews 同时传 lang 时由 lang 映射覆盖此值;语言选择不保证所有评论原文属于该语言。
since可选
评论发布时间下界,建议 YYYY-MM-DD;用于评论读取,不是商户开业日期。profile 也公开此参数,但不能据此认为地点详情按开业时间过滤。
sort可选
评论顺序:newest 最新,relevance 平台相关度;reviews 默认 newest。profile 中同名参数只涉及可能附带的评论信息,不排序单个商户对象。
查看全部 2 个允许值

newestrelevance

谷歌地图点评 特有返回字段与含义(13)
place_id
Google 地点 ID,跨 Google 服务通用的唯一标识。
categories
地点分类(餐厅/酒店等)。
state
州/省。
postal_code
邮编。
country_code
国家代码。
lat
纬度。
lng
经度。
permanently_closed
是否已永久停业。抓到 true 的店不必再分析。
neighborhood
所在街区。
plus_code
Google Plus Code(开放位置编码),无门牌地址地区用它定位。
opening_hours
营业时间表。
temporarily_closed
是否临时歇业。
image_count
该点评附图数量。

怎么调用 谷歌地图点评 评价 API?

reviews

使用 platform="google_maps_reviews"、action="reviews" 调用“评价”能力;返回列表,默认 20 条、单次最多 100 条,主要包含 id、text、rating、rating_scale、reviewer_name、reviewer_review_count 等 17 个字段。

谷歌地图点评 reviews 的参数分别是什么意思?

url必填
Google Maps 地点完整链接,优先使用搜索结果中保留 query_place_id 的 URL;仅有店名与地图坐标的 /place/ 链接可能无法稳定定位同一家店。profile 查商户资料,reviews 查该商户评论。

Google Maps 链接可用 query_place_id 定位具体地点,而不只依赖地点名称或坐标。官方来源:Google Maps:地点链接与 Place ID来源核查:

lang可选
reviews 的语言选项:en 英语、zhcn 简体中文、zhtw 繁体中文等,完整清单见本接口允许值;映射后优先于 language。不是按评论作者国籍筛选。
查看全部 74 个允许值

afamarazbgbnbscacsdadeeleneses419eteufafifilfrglguhihrhuhyidisitiwjakakkkmknkokyloltlvmkmlmnmrmsmynenlnopaplptbrptptrorusiskslsqsrsvswtatethtrukuruzvizhcnzhtwzu

language可选
查询/页面内容语言,默认 en。reviews 同时传 lang 时由 lang 映射覆盖此值;语言选择不保证所有评论原文属于该语言。
since可选
评论发布时间下界,建议 YYYY-MM-DD;用于评论读取,不是商户开业日期。profile 也公开此参数,但不能据此认为地点详情按开业时间过滤。
sort可选
评论顺序:newest 最新,relevance 平台相关度;reviews 默认 newest。profile 中同名参数只涉及可能附带的评论信息,不排序单个商户对象。
查看全部 2 个允许值

newestrelevance

谷歌地图点评 特有返回字段与含义(9)
place_id
Google 地点 ID,跨 Google 服务通用的唯一标识。
place_name
地点名称。
detailed_rating
分维度评分(食物/服务/氛围等)。
reviewer_name
点评人名称。
reviewer_review_count
点评人的历史点评总数。数量多的评价者更可信。
is_local_guide
是否为 Google 本地向导(活跃点评者认证)。
owner_response
商家对点评的回复。
owner_response_at
商家回复时间。
image_urls
点评附图。
谷歌地图点评 search 调用流程一次 谷歌地图点评 search 调用的全过程:向 POST /api/v1/social 发送 platform="google_maps_reviews"、action="search",以及必填参数 keyword;返回结构化 JSON,含 place_id、name、url、category、categories 等字段;返回列表,单次最多 50 条,计费 $1.39 / 千次,失败与空结果不计费。1 · 请求POST /api/v1/socialplatform: "google_maps_reviews"action: "search"keywordEveryInfra$1.39 / 千次2 · 响应 · 列表place_idnameurlcategorycategories
一次 谷歌地图点评 search 调用的全过程:向 POST /api/v1/social 发送 platform="google_maps_reviews"、action="search",以及必填参数 keyword;返回结构化 JSON,含 place_id、name、url、category、categories 等字段;返回列表,单次最多 50 条,计费 $1.39 / 千次,失败与空结果不计费。

谷歌地图点评 原始字段名

EveryInfra 统一字段名

左边是 谷歌地图点评 数据里原本的字段名,右边是我们统一后的。点任意一行看对应关系。89 个平台复用通用字段命名,减少重复适配; 切换平台仍需核对参数、字段集合、类型与空值含义。这里展示映射关系,不是目标的实时返回数据。

谷歌地图点评 的独有字段名(当前目录)

全站 89 个平台的当前目录中,这 9 个字段名只在 谷歌地图点评 出现。 这是字段命名的分布,不代表其他平台没有同类信息,也不保证每次响应都含这些字段;具体含义和返回条件仍需逐接口核对。

  • permanently_closed
  • plus_code
  • temporarily_closed
  • opening_hours
  • reviewer_name
  • reviewer_review_count
  • is_local_guide
  • owner_response_at
  • detailed_rating

返回字段含义

通用字段采用统一命名;切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。 机器可读版:/api/v1/social/fields

place_id
Google 地点 ID,跨 Google 服务通用的唯一标识。
name
名称。用于账号/商品/商家类能力,指该对象本身的名字。
url
该记录在原平台上的可访问链接。
category
分类名称,取值为原平台的分类体系,未做跨平台归一。
categories
地点分类(餐厅/酒店等)。
description
简介或描述,通常比 text 短。
address
详细地址,原文透传。
city
城市名,用原平台的语言书写,未做中英归一。
state
州/省。
postal_code
邮编。
country_code
国家代码。
lat
纬度。
lng
经度。
phone
联系电话,原文透传,未做号码格式归一。
website
账号或商家填写的外链网址。
rating
评分。分制随平台而异,同一行的 rating_scale 给出该平台满分 (多数是 5,Booking/豆瓣/爱奇艺/NAVER 是 10)。跨平台比较前必须先按 rating_scale 换算 —— 直接比数字会得出反的结论。
rating_scale
上一列 rating 的满分。5 表示五星制、10 表示十分制。只在该行有 rating 时出现。
review_count
评价条数,用于商品/商家类能力。null 表示不公开,不等于 0。
price
价格数值,不含货币符号;币种见 currency。
permanently_closed
是否已永久停业。抓到 true 的店不必再分析。
image_url
图片链接。多图能力可能返回 image_urls 数组。
platform
数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。
neighborhood
所在街区。
plus_code
Google Plus Code(开放位置编码),无门牌地址地区用它定位。
image_count
该点评附图数量。
temporarily_closed
是否临时歇业。
opening_hours
营业时间表。
id
该记录在原平台上的唯一标识。仅在同一平台内唯一,跨平台可能重复。
text
正文内容,已去除 HTML 标签。长文可能被截断。
reviewer_name
点评人名称。
reviewer_review_count
点评人的历史点评总数。数量多的评价者更可信。
is_local_guide
是否为 Google 本地向导(活跃点评者认证)。
like_count
点赞数。null 表示该平台或该接口不公开此数据,不等于 0。
posted_at
发布时间,ISO 8601 格式、UTC 时区(如 2026-08-07T12:34:56+00:00)。平台只给非标准字符串时原样透传,解析前建议做容错。null 表示平台未公开。
owner_response
商家对点评的回复。
owner_response_at
商家回复时间。
detailed_rating
分维度评分(食物/服务/氛围等)。
image_urls
点评附图。
place_name
地点名称。

请求填写示例

将商家类别与城市写入地点检索词;精确点评目标使用地点接口要求的标识。

以下为填写格式示意,并非成功调用记录。请替换 API Key 和尖括号中的目标,确认可选筛选项后再调用;示例不保证目标当前有数据。

google_maps_reviews_search.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer omg_你的KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"google_maps_reviews","action":"search","params":{"keyword":"coffee shops in Seattle"}}'

记录字段预览(非真实响应)

仅展示 search 的记录字段,不包含外层响应、计费或任务状态。null 只作展示占位,不表示字段类型或实际空值;完整响应须以接口文档与实际调用为准。

fields.preview.json
{
  "place_id": null,
  "name": null,
  "url": null,
  "category": null,
  "categories": null,
  "description": null,
  "address": null,
  "city": null,
  "state": null,
  "postal_code": null,
  "country_code": null,
  "lat": null,
  "lng": null,
  "phone": null,
  "website": null,
  "rating": null,
  "rating_scale": null,
  "review_count": null,
  "price": null,
  "permanently_closed": null,
  "image_url": null,
  "platform": null
}

常见用例

以下是基于现有接口的接入思路,不是开箱即用的分析或告警功能。字段以实际返回为准,缺失值不按零处理。

本地同类商户调研

按商户名称或类目搜索 Google Maps 地点,建立候选清单。

查看 search 的 keyword 参数 →
  • 结合 name、address、category 和 place_id 核对分店,避免混淆同名地点。
  • 搜索结果不是当地全部商户名录,也不代表固定地图排名。

门店资料与营业信息核对

用具体地点 URL 读取地址、网站和营业时间等公开资料。

查看 profile 的 url 参数 →
  • 按 place_id 区分门店,结合 opening_hours、website 与 address 核对资料。
  • 字段缺失不等于门店停业;此接口不能修改 Google 商家资料。

Google Maps 评论 API 如何按日期整理评价和商家回复?

读取具体地点的评价,整理低分问题及已公开的商家回复。

查看 reviews 的 since 参数 →
  • 结合 rating、text、posted_at 与 owner_response 分析;since 是评论日期下界。
  • 这不等于拥有发布回复的权限;lang 也不是评论作者国籍筛选。

谷歌地图点评 教程与实战

先在本页核对当前 action、参数与字段,再按真实任务进入完整步骤或相邻方法;文章中的示例和边界不会替代本页机器目录。

指南

Google Maps 评论 API:选对入口,再建立地点与评论记录

区分 Business Profile、Places API 与 EveryInfra 地点评论读取,核对地点身份、语言和时间筛选,保留评分与商家回复变化,并明确样本、存储和展示边界。

阅读完整文章 →
Blog

Google Maps 门店数据怎么去重:Place ID 不是永久业务身份

同一地点可能有多个 Place ID,地点 ID 也可能变化。结合 Google 官方说明,讨论连锁分店去重、内部实体映射、搬迁记录与误合并的验证方法。

阅读完整文章 →
指南

多平台口碑监控蓝图:先记录采集范围,再判断负面变化

从目标清单、评论身份和增量游标开始,设计可追溯的口碑监控流程;用离线样本演示去重与采集缺口,保留人工复核,不冒充客户案例。

阅读完整文章 →

谷歌地图点评 API 常见问题

谷歌地图点评 API 怎么调用?

调用 POST /api/v1/social,请求体传 platform="google_maps_reviews"、action 和 params。以 search 为例,必填 keyword,可选 country、language、location。将商家类别与城市写入地点检索词;精确点评目标使用地点接口要求的标识。 谷歌地图点评 共 3 个 action,鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 89 个平台。

谷歌地图点评 API 怎么收费?

$1.39 / 千次,谷歌地图点评 全部 3 个能力同价。按本页最高能力单价、每次单目标估算,$1 免费额度约可用于 719 次 谷歌地图点评 调用。费用按所选能力与目标数量计算,多目标请求不要按单目标估算;参数错误、鉴权失败和空结果不计费。

谷歌地图点评 API 一次能返回多少条数据?

谷歌地图点评 有 2 个列表接口,包括 search、reviews。其余 1 个接口返回单个对象;对象内仍可能包含数组。数量参数要逐接口区分目标数、页数和记录数,不能将目录数值直接当作保证返回的条数;具体限制见对应参数与用例,不保证完整历史。

谷歌地图点评 API 返回哪些字段?

当前目录为 search 列出 place_id、name、url、category、categories、description 等 22 个字段名。按全站当前目录统计,9 个字段名只在 谷歌地图点评 出现;这不表示其他平台没有同类信息。字段不保证每次齐全,嵌套位置、类型与空值须按各接口说明核对,同名字段不代表语义可互换。

「本地同类商户调研」怎样接入 谷歌地图点评 API?

按商户名称或类目搜索 Google Maps 地点,建立候选清单。 结合 name、address、category 和 place_id 核对分店,避免混淆同名地点。 搜索结果不是当地全部商户名录,也不代表固定地图排名。

「门店资料与营业信息核对」怎样接入 谷歌地图点评 API?

用具体地点 URL 读取地址、网站和营业时间等公开资料。 按 place_id 区分门店,结合 opening_hours、website 与 address 核对资料。 字段缺失不等于门店停业;此接口不能修改 Google 商家资料。

Google Maps 评论 API 如何按日期整理评价和商家回复?

读取具体地点的评价,整理低分问题及已公开的商家回复。 结合 rating、text、posted_at 与 owner_response 分析;since 是评论日期下界。 这不等于拥有发布回复的权限;lang 也不是评论作者国籍筛选。

可以先免费试用 谷歌地图点评 API 吗?

可以。注册免费,加微信领邀请码可得 $1 免费额度(≈720 次数据调用)。请先选择 谷歌地图点评 的目标接口,用单目标请求核对结果;实际可调用次数取决于能力价格与目标数量,不保证覆盖全部 3 个能力。无需信用卡。

开始调用 谷歌地图点评 API

加微信领 $1 免费额度,先选一个 谷歌地图点评 接口验证结果。实际可调用次数取决于能力价格与目标数量。

免费开始