Skip to main content
GET
按 id 获取 Business Data Google 评论结果

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

路径参数

id
string
必填

DataForSEO 任务 ID。

查询参数

id
string

任务标识符 本系统中采用 UUID 格式的唯一任务标识符;你可以在 30 天内随时使用它请求任务结果。

响应

成功响应

version
string

API 的当前版本

version.status_code
integer

常规状态代码 您可以在此处查看完整的响应代码列表。注意:我们强烈建议设计必要的系统来处理相关异常或错误情况

version.status_message
string

一般信息消息 你可以在此处查看一般信息消息的完整列表

version.time
string

执行时间(秒)

version.cost
number

所有任务的总成本(美元)

version.tasks_count
integer

tasks 数组中的任务数量

version.tasks_error
integer

tasks 数组中返回错误的任务数量

tasks
string[]

任务数组

tasks.id
string

任务标识符 我们系统中采用 UUID 格式的唯一任务标识符

tasks.status_code
integer

由 DataForSEO 生成的任务状态码;范围为 10000-60000;你可以在此处查看完整的响应代码列表

tasks.status_message
string

任务的提示信息 你可以在此处查看通用提示信息的完整列表

tasks.time
string

执行时间(秒)

tasks.cost
number

任务成本(美元)

tasks.result_count
integer

result 数组中的元素数量

tasks.path
string[]

URL 路径

tasks.data
object

包含与您在 POST 请求中指定的参数相同的参数

result
string[]

结果数组

result.keyword
string

在 POST 数组中接收的 keyword 返回的 keyword 会对 %## 进行解码(加号字符“+”将被解码为空格字符)

result.type
string

POST 数组中的搜索引擎类型

result.se_domain
string

POST 数组中的搜索引擎域名

result.location_code
integer

POST 数组中的位置代码

result.language_code
string

POST 数组中的语言代码

result.check_url
string

搜索引擎结果的直接 URL,你可以使用它确认我们提供的结果是否准确

result.datetime
string

收到结果的日期和时间,采用 UTC 格式:“yyyy-mm-dd hh-mm-ss +00:00”;示例:2019-11-15 12:57:46 +00:00

result.title
string

SERP 中“reviews”元素的标题 收集评论的本地场所名称

result.sub_title
string

SERP 中 ‘reviews’ 元素的副标题 收集评论的 ‘reviews’ 元素的附加信息(例如地址)

result.rating
object

对应本地商家的评分 基于评论计算并显示在 SERP 中的热门度评分

result.rating_type
string

评分类型,此处可包含以下元素:Max5PercentsCustomMax

result.value
number

基于所有评论的平均评分

result.votes_count
integer

投票数

result.rating_max
integer

rating_type 的最大值

result.feature_id
string

SERP 中“reviews”元素的唯一标识符 如需详细了解该标识符,请参阅此帮助中心文章

result.place_id
string

由 Google 分配的商家位置唯一标识符 有关该标识符的更多信息,请参阅此帮助中心文章

result.cid
string

Google 定义的客户端 id 本地商家的唯一 id;有关该标识符的更多信息,请参阅此帮助中心文章

result.reviews_count
integer

评论总数

result.items_count
integer

结果数组中的评论条目数量 设置任务时,可以使用 depth 参数获取更多结果

items
string[]

找到的评论 设置任务时,可使用 depth 参数获取更多结果

items.type
string

元素类型 = ‘images_element’

items.rank_group
integer

在具有相同 type 值的一组元素中的位置 具有不同 type 值的元素的位置不计入 rank_group

items.rank_absolute
integer

在所有列出的评论中的绝对排名 在列表中所有评论中的绝对位置

items.position
string

评论在 SERP 中的对齐方式可取以下值:right

items.xpath
string

评论的 XPath

items.review_text
string

评论内容

items.original_review_text
string

评论的原始内容 评论的原始内容,未应用自动翻译

items.time_ago
string

发布时间 表示评论发布的时间(采用“多久以前”格式)

items.timestamp
string

评论发布日期和时间,采用 UTC 格式:“yyyy-mm-dd hh-mm-ss +00:00”;示例:2019-11-15 12:57:46 +00:00

items.rating
object

评论者提交的评分

items.rating_type
string

评分类型,可取以下值:Max5

items.value
number

评分值

items.votes_count
integer

反馈数量表示该评论获得的投票数

items.rating_max
integer

rating_type 的最大值 Max5 的最大值为 5

items.reviews_count
integer

评论者提交的评论总数

items.photos_count
integer

评论者提交的照片总数

items.local_guide
boolean

表示评论者是否具有“本地向导”身份

items.profile_name
string

审核者的个人资料名称

items.profile_url
string

评价者个人资料的 URL

items.review_url
string

评论的 URL

items.profile_image_url
string

评论者个人资料图片的 URL

items.owner_answer
string

业主回复的文本 业主对评论的回复

items.original_owner_answer
string

所有者回复的原始文本 对评论的原始回复,未应用自动翻译

items.owner_time_ago
string

发布时间 表示所有者提交评论回复的时间(采用“多久以前”格式)

items.owner_timestamp
string

所有者回复评论的日期和时间,采用 UTC 格式:“yyyy-mm-dd hh-mm-ss +00:00”;示例:2019-11-15 12:57:46 +00:00

items.review_id
string

Google 评论的唯一标识符 示例:ChZDSUhNMG9nS0VJQ0FnSUMxbHFyMFlnEAE

items.images
string[]

审核者提交的图片

items.alt
string

图像的 alt 标签

items.url
string

来自 Google 的相关图片 URL

items.image_url
string

评论中所展示图片的 URL

items.review_highlights
string[]

评论亮点包含重点评论标准和评价

items.feature
string

已审核功能

items.assessment
string

功能评估