Google Maps レビューAPI

任意のGoogleマップ場所のユーザーレビューを取得します。engine=google_maps_reviewsを設定し、Googleマップのレスポンスからdata_idを渡すことで、評価、日付、テキストを含むレビューの構造化リストを取得できます。

エンドポイント

GET https://serp.shifter.io/v1?engine=google_maps_reviews&api_key=YOUR_API_KEY

パラメータ

パラメータ	型	必須	説明
api_key	string	yes	SERP APIキー
engine	string	yes	google_maps_reviewsである必要があります
data_id	string	yes	場所のGoogleマップデータID
topic_id	string	no	トピックIDでレビューをフィルタリング
hl	string	no	インターフェース言語コード
sort_by	string	no	qualityScore、newestFirst、ratingHigh、またはratingLow
next_page_token	string	no	次のページを取得するための、前回のレスポンスから得たトークン

リクエスト例

curl

curl "https://serp.shifter.io/v1?engine=google_maps_reviews&api_key=YOUR_API_KEY&data_id=0x4786c6ace45fe3bd:0x126d84580eedebe5"

Python

import requests

params = {
    "engine": "google_maps_reviews",
    "api_key": "YOUR_API_KEY",
    "data_id": "0x4786c6ace45fe3bd:0x126d84580eedebe5",
}
r = requests.get("https://serp.shifter.io/v1", params=params)
data = r.json()

Node.js

import fetch from 'node-fetch';

const url = 'https://serp.shifter.io/v1?' + new URLSearchParams({
  engine: 'google_maps_reviews',
  api_key: 'YOUR_API_KEY',
  data_id: '0x4786c6ace45fe3bd:0x126d84580eedebe5',
});
const data = await (await fetch(url)).json();

レスポンス例

{
  "search_parameters": {
    "engine": "google_maps_reviews",
    "data_id": "0x4786c6ace45fe3bd:0x126d84580eedebe5"
  },
  "place_info": {
    "title": "Joe's Pizza",
    "rating": 4.5,
    "reviews": 2431
  },
  "reviews": [
    {
      "user": {
        "name": "Jane Doe",
        "contributor_id": "1234567890",
        "reviews": 42
      },
      "rating": 5,
      "date": "a month ago",
      "snippet": "Best slice in town. Quick service and a classic NYC vibe."
    }
  ],
  "serpapi_pagination": {
    "next_page_token": "CAESBkN..."
  }
}

関連情報

• Google SERP概要
• レスポンスの形式
• Google Maps API
• Google Maps Photos API