APIキーを作成
APIワークスペースで認証情報を作成し、サーバーまたはクライアントのシークレット設定に保管します。RESTとMCPは同じAPI利用枠を共有します。
APIキーを開く構造化JSON
同じレスポンスで結果を返却
REST + MCP
アプリケーションまたはAIクライアントから利用
1つのAPI利用枠
APIとMCPリクエストで共有
データを選ぶ
まずビジネス検索から始め、場所のfeature IDを使ってレビューやギャラリー項目をリクエストします。各APIには独自のサンプルとフィールドリファレンスがあります。
初めてのAPIリクエスト
AuthorizationヘッダーでAPIキーを使用します。以下のリクエスト形式を確認し、クイックスタートに沿って最初の呼び出しを行ってください。
完全な仕様については、APIドキュメントをご覧ください。
curl https://gmapscrawl.com/api/v1/search \
-H "Authorization: Bearer $GMSCRAPER_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: seattle-coffee-search-001" \
-d '{"q":"coffee shops in Seattle","page":1,"extra":false}'例示用の空のレスポンスです。ライブ検索では利用可能なビジネスが返ります。APIキーはサーバーサイドに保管し、新しい処理には新しい冪等キーを使い、変更しないリトライでは同じキーを保持してください。
{
"data": {
"total": 0,
"params": {
"q": "coffee shops in Seattle",
"page": 1,
"hl": "en",
"extra": false
},
"businesses": []
},
"request_id": "req_example",
"schema_version": "2026-09-22"
}APIは同じレスポンス内でJSONを返します。タイムアウト後は、変更していないボディを同じIdempotency-Keyで再試行してください。テスト用認証情報では、実際の利用枠を消費せずにシミュレートされたデータが返ります。
標準的なHTTPで構築
APIワークスペースで認証情報を作成し、サーバーまたはクライアントのシークレット設定に保管します。RESTとMCPは同じAPI利用枠を共有します。
APIキーを開くキーワードと地域で検索します。レビューや写真には、お持ちのMaps feature IDを指定するか、検索結果からplace.dataIdを読み取ってください。
クイックスタートに進む返されたページをアプリケーションで処理します。エンドポイントのページネーションルールに従い、欠損フィールドを確認し、リトライ用にリクエストの冪等キーを保持してください。
ページネーションを理解する役立つものを作る
返されたレコードを、独自の調査、レポート、社内ワークフローへの入力として使用します。
カテゴリと地域で検索し、利用可能なビジネス名、住所、Webサイト、電話番号、評価をアプリケーションで整理します。
場所の公開レビューを調べて顧客のフィードバックを分析します。一貫した並び順を選び、分析に必要なページを順に取得します。
場所で利用可能な写真・動画リンクを取得します。チームが元のコンテキストを確認できるよう、ソースのギャラリーリンクをレコードと一緒に保持します。
エージェントと接続
MCPサーバーに接続して検出可能なツールを利用するか、Agent Skillをインストールして再利用可能なワークフロー手順とRESTフォールバックを取得します。
接続したエージェントへのタスク例
「シアトルのコーヒーショップを1ページ分検索して。取得できた名前、Webサイト、評価を返して、欠損データを指摘して。」
リクエストはAPI利用枠を消費します。テスト用認証情報では、結果はシミュレートされます。
統合を計画する
成功したライブページは、空のページを含め、1件につき1 APIリクエストを消費します。RESTとMCPはAPIプランを共有し、OnlineとExtensionの利用枠は別です。
まず1ページから始め、返されたフィールドを確認し、エンドポイントに適したクライアントタイムアウトを設定します。リトライ時は、変更していないリクエストボディで同じIdempotency-Keyを再利用してください。
プランの上限、レート制限、ソースの可用性、エンリッチメントはライブリクエストに影響します。テスト用認証情報は、ライブ利用枠を消費せずにシミュレートされたフィクスチャを返します。
リクエスト上限と結果フィールドについては各エンドポイントのページをご覧ください。料金ページには現在の付帯リクエスト数と有料の超過料金が記載されています。
G Maps Crawlは、ビジネス検索、公開レビュー、場所の写真・ギャラリーAPIを提供しています。Searchはビジネスレコードを返し、ReviewsとPhotosはMaps feature IDを使って特定の場所の1ページを返します。
はい。APIはHTTPリクエストとJSONを使用するため、Python、JavaScript、cURL、その他のHTTPクライアントから呼び出せます。各APIページにはリクエスト例とレスポンス例が含まれています。
公開されているSearch、Reviews、Photos APIは、同じレスポンス内でJSONを返します。ジョブのポーリングやwebhookの設定は不要です。エンドポイントのタイムアウトとリトライのガイダンスに従ってください。
RESTではアプリケーションからエンドポイントを直接呼び出せます。MCPは対応するAIクライアントにツールを提供します。Agent Skillはワークフロー手順とヘルパースクリプトを提供します。RESTとMCPのリクエストにはAPI認証情報が必要で、API利用枠を消費します。
お持ちのMaps feature IDを使うか、Search APIのdata.businesses配列内の一致するレコードからplace.dataIdをコピーします。その値をfidとしてReviewsまたはPhotos APIに渡します。
いいえ。返されるフィールドはソースと選択したオペレーションによって異なります。データを使用する前に、欠損値と利用可能な観測タイムスタンプを確認してください。成功したレスポンスに空のページが含まれる場合があります。