Google Maps Reviews API

Google Maps Reviews

主要特性

• 按已知 URL 批量提交在一个异步任务中提交一个或多个受支持的 google.com 或 goo.gl URL，无需先调用另一套标识解析接口。
• 可选天数窗口需要近期评价时，可把同一个正整数 days_limit 应用到每个提交的 URL 行。
• 稳定评价结构通过 [email protected] 结构读取评价标识、文本、评价者字段、评分、地点引用、时间、来源 URL 和可用媒体。

参数

如何使用

提交已知 Google Maps URL，跟踪异步任务，并通过任务结果 cursor 读取已保存的评价记录。

1. 准备一个或多个位于 google.com 或 goo.gl 的受支持 Google Maps 地点 URL。
2. 向 /v1/google-maps/reviews POST urls，并按需添加 days_limit 与 results_limit。
3. 轮询 /v1/tasks/{task_id}，直到 status 变为 succeeded 或 failed。
4. 读取 /v1/tasks/{task_id}?limit=50；当 results.has_more 为 true 时，继续传入 results.next_cursor。

curl -X POST "https://api.socq.ai/v1/google-maps/reviews" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.google.com/maps/place/Coffee%20Project%20New%20York%20%7C%20East%20Village/data=!4m7!3m6!1s0x89c2599b5a24d7fd:0x9e354f6cf514b9fc!8m2!3d40.7270884!4d-73.9893820!16s%2Fg%2F11c3svpqld!19sChIJ_dckWptZwokR_LkU9WxPNZ4?authuser=0&hl=en&rclk=1"],"days_limit":3650,"results_limit":3}'

# 轮询 GET /v1/tasks/{task_id}，然后请求
# GET /v1/tasks/{task_id}?limit=50&cursor={results.next_cursor}。

最佳使用场景

• 已知地点反馈数据集： 为一组明确的公开地点 URL 整理评价文本、评分、发布时间和来源链接。
• 保留来源的评价者研究： 保留可用的评价者姓名、username、主页链接和评价 URL，使每条记录都能回到公开上下文。
• 近期窗口比较： 在不同时间对同一地点集合使用已记录的 days_limit，比较有边界的采集结果，而不把它误写成完整历史。
• 带媒体的评价归档： 把可用评价媒体与文本、评分、地点引用和采集时间一起保存为标准化研究记录。

使用建议

• 提交可解析的 google.com 或 goo.gl Maps URL；地点名称、Google Business Profile 账号或单独的 Place ID 不能作为 urls 项。
• 只有确实需要正整数时间窗口时才设置 days_limit；省略它会让 provider 输入行不带该筛选。
• 把 results_limit 视为整批 URL 共用的已保存结果总上限，不要理解为每个 URL 的返回承诺。
• 区分提交时的 results_limit 与读取结果时的 limit；后者只控制 1 到 500 的单页大小，并配合不透明 cursor。
• 当公开来源没有暴露某个值时，应允许文本、评价者属性、评分、地点引用、时间和媒体为空。

相关 API