Google Maps API

Google Maps 评价 API

按地点 ID 获取某个地点最多 100 条 Google Maps 评价,按你需要的方式排序,在一次标准化响应中返回。

POST/v1/run/maps.reviews
可用率
99.47%
30d · 16,512 次调用
请求数
17,144
30d · 按周,近 12 周
响应时间
16.2s
中位数 · 30d

试一试

发出你的第一个请求

requireFieldsarray
可选;省略时路由不变,由最便宜的数据源处理。列出本次请求必须能返回的输出字段,例如 `isLocalGuide` 或 `placeId`,请求就只会由能返回全部这些字段的数据源处理。未列出的字段,只要处理请求的数据源有,仍会照常返回。这可能提高你的价格:最便宜的数据源无法返回某个列出的字段时,会改由更贵的数据源处理,并按它的价格报价和扣费。如果某条评价确实没有某个列出的字段,该字段仍可能缺失。如果列出的字段组合没有任何单一数据源能同时返回,请求会作为无效输入被拒绝,不扣费。
打开于
获取免费密钥
示例响应
免费运行只返回前 3 条结果。为密钥充值即可获得完整响应。
{
  "data": {
    "items": [
      {
        "author": "Alex Rivera",
        "authorUrl": "https://example.com/page",
        "avatarUrl": "https://example.com/image.jpg",
        "createdUtc": 12.5,
        "isLocalGuide": true,
        "likes": 12500,
        "origin": "example",
        "ownerResponse": "Alex Rivera",
        "ownerResponseAt": "Alex Rivera",
        "placeId": "a1b2c3d4",
        "publishedAgo": "2024-01-15T09:30:00Z",
        "rating": 4.6,
        "reviewId": "A short example description of this item.",
        "reviewerId": "A short example description of this item.",
        "reviewerReviewsCount": 12500,
        "text": "A short example description of this item.",
        "url": "https://example.com/page"
      }
    ]
  },
  "found": true,
  "reason": "not_found"
}
响应类型定义
interface MapsReviewsResponse {
  data: {
    items: {
      author?: string;
      authorUrl?: string;
      avatarUrl?: string;
      createdUtc?: number;
      isLocalGuide?: boolean;
      likes?: number;
      origin?: string;
      ownerResponse?: string;
      ownerResponseAt?: string;
      placeId?: string;
      publishedAgo?: string;
      rating?: number;
      reviewId: string;
      reviewerId?: string;
      reviewerReviewsCount?: number;
      text?: string;
      url?: string;
    }[];
  } | null;
  found: boolean;
  reason?: "not_found";
}

完整的参数与响应参考:这个接口的每个字段、类型和示例。

参考

请求、响应与价格

最近验证于 2026-09-29 · 可用率和延迟按 30d 统计
POST /v1/run/maps.reviews
curl -X POST https://api.getanyapi.com/v1/run/maps.reviews \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":3,"placeId":"ChIJN1t_tDeuEmsRUsoyG83frY4"}'
字段类型示例值
请求体
placeIdstring"ChIJN1t_tDeuEmsRUsoyG83frY4"要获取评价的 Google Maps 地点 ID(例如 ChIJj61dQgK6j4AR4GeTYWZsKWw)。
languagestring评价详情使用的两字母语言代码(例如 en)。
limitinteger3最多返回的结果数(1-100,默认 100)。
postedLimitenum仅返回在此时间范围内发布的评价:24h(过去 24 小时)、week(过去 7 天)、month(过去一个月)或 year(过去一年)。省略则不按时间筛选。
requireFieldsarray可选;省略时路由不变,由最便宜的数据源处理。列出本次请求必须能返回的输出字段,例如 `isLocalGuide` 或 `placeId`,请求就只会由能返回全部这些字段的数据源处理。未列出的字段,只要处理请求的数据源有,仍会照常返回。这可能提高你的价格:最便宜的数据源无法返回某个列出的字段时,会改由更贵的数据源处理,并按它的价格报价和扣费。如果某条评价确实没有某个列出的字段,该字段仍可能缺失。如果列出的字段组合没有任何单一数据源能同时返回,请求会作为无效输入被拒绝,不扣费。
reviewsFilterStringstring仅返回文本包含此关键词或短语的评价(不区分大小写)。省略则返回所有评价(例如 parking)。
sortenum评价的返回顺序(例如 newest)。
响应
dataobjectThe reviews result, or null when not found.
data.itemsobject[]Review records: reviewer, star rating, review text (empty when the reviewer left only a rating), publish date, likes, and owner response where present. Populated whenever the provider has data for the entity.
data.items[].authorstringReviewer display name. Populated whenever the provider has data for the entity.
data.items[].authorUrlstringGoogle Maps contributor page URL for the reviewer.
data.items[].avatarUrlstringReviewer profile photo URL.
data.items[].createdUtcnumberUTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. Populated whenever the provider has data for the entity.
data.items[].isLocalGuide可设为必填booleanWhether the reviewer is a Google Local Guide.
data.items[].likes可设为必填integerNumber of likes on the review.
data.items[].origin可设为必填stringSource of the review (e.g. Google).
data.items[].ownerResponsestringOwner's reply text; empty when there is none.
data.items[].ownerResponseAt可设为必填stringISO 8601 timestamp of the owner's reply; empty when there is none.
data.items[].placeId可设为必填stringGoogle Maps place id the review belongs to. Echoes the requested placeId; a lane that does not repeat it per review omits it.
data.items[].publishedAgostringHuman-relative publish time (e.g. '7 hours ago').
data.items[].ratingnumberStar rating the reviewer gave (1-5).
data.items[].reviewIdstringStable Google review id. Populated whenever the provider has data for the entity.
data.items[].reviewerIdstringStable Google id of the reviewer.
data.items[].reviewerReviewsCountintegerTotal number of reviews the reviewer has written.
data.items[].textstringReview text; empty string when the reviewer left only a star rating.
data.items[].urlstringDirect URL to the review on Google Maps. Populated whenever the provider has data for the entity.
foundbooleanWhether reviews were found.
reason"not_found"Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
价格
每次请求价格USDUS$0.0035
价格(/千次请求)USDUS$3.50

常见问题

关于 Google Maps 评价 API

AnyAPI 的 Google Maps 评价 API 只需一次 POST 请求 /v1/run/maps.reviews,就以统一格式的 JSON 返回 Google Maps 数据。按地点 ID 获取某个地点最多 100 条 Google Maps 评价,按你需要的方式排序,在一次标准化响应中返回。AnyAPI 会在 4 个数据源之间路由每个请求,某个数据源失败时自动切换。费用:每千次请求 US$3.50 起,以美元计价,无需订阅,也没有每月最低消费。过去 30 天,通过 AnyAPI 发起的 Google Maps 评价 API 调用中有 99.5% 成功,响应时间中位数为 16.2 秒,共测量 16,512 次调用。

费用:每千次请求 US$3.50 起,以美元计价,无需订阅,也没有每月最低消费。你只需为一个美元钱包充值,每次调用从中扣费。部分由钱包付费的失败请求会产生处理费用,我们按成本原价转嫁,不加价;错误响应会显示收取的金额。

按地点 ID 获取某个地点最多 100 条 Google Maps 评价,按你需要的方式排序,在一次标准化响应中返回。响应是统一格式的 JSON,外层结构与每个 AnyAPI 接口相同,所以解析另一个接口只需换一个 URL,别的都不用改。

过去 30 天,通过 AnyAPI 发起的 Google Maps 评价 API 调用中有 99.5% 成功,响应时间中位数为 16.2 秒,共测量 16,512 次调用。这些是 AnyAPI 对经过网关的流量的自有测量,持续重新计算,并非公开承诺的服务等级目标。