API-Schlüssel erstellen
Erstellen Sie Zugangsdaten in Ihrem API-Workspace und bewahren Sie sie in der geheimen Konfiguration Ihres Servers oder Clients auf. REST und MCP nutzen dasselbe API-Kontingent.
API-Schlüssel öffnenG Maps Crawl für Entwickler
Suchen Sie Unternehmen, lesen Sie öffentliche Bewertungen und durchsuchen Sie Fotos und Videos von Orten. Entwickeln Sie mit einer synchronen REST-API oder geben Sie Ihrem KI-Assistenten über MCP Zugriff.
Strukturiertes JSON
Ergebnisse in derselben Antwort
REST + MCP
Mit Ihrer Anwendung oder Ihrem KI-Client nutzen
Ein API-Kontingent
Gemeinsam für API- und MCP-Anfragen
Wählen Sie Ihre Daten
Beginnen Sie mit einer Unternehmenssuche und nutzen Sie dann die Feature-ID des Ortes, um Bewertungen oder Galerieeinträge abzurufen. Jede API hat eigene Beispiele und eine Feldreferenz.
Ihre erste API-Anfrage
Verwenden Sie einen API-Schlüssel im Authorization-Header. Sehen Sie sich die Anfrageformate unten an und folgen Sie dann dem Quickstart für Ihren ersten Aufruf.
Den vollständigen Vertrag finden Sie in der API-Dokumentation.
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}'Beispielhafte leere Antwort. Eine Live-Suche liefert verfügbare Unternehmen. Halten Sie Ihren API-Schlüssel serverseitig; verwenden Sie einen neuen Idempotenz-Schlüssel für neue Arbeit und bewahren Sie ihn für eine unveränderte Wiederholung auf.
{
"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"
}Die API liefert JSON in derselben Antwort. Nach einem Timeout wiederholen Sie den unveränderten Body mit demselben Idempotency-Key. Test-Zugangsdaten liefern simulierte Daten, ohne Ihr Live-Kontingent zu verbrauchen.
Entwickeln mit Standard-HTTP
Erstellen Sie Zugangsdaten in Ihrem API-Workspace und bewahren Sie sie in der geheimen Konfiguration Ihres Servers oder Clients auf. REST und MCP nutzen dasselbe API-Kontingent.
API-Schlüssel öffnenSuchen Sie mit einem Keyword und einem Standort. Für Bewertungen und Fotos geben Sie die Maps-Feature-ID an, die Sie bereits haben, oder lesen Sie place.dataId aus einem Suchergebnis.
Quickstart folgenVerarbeiten Sie die zurückgegebene Seite in Ihrer Anwendung. Beachten Sie die Paginierungsregeln des Endpunkts, prüfen Sie fehlende Felder und bewahren Sie den Idempotency-Key der Anfrage für Wiederholungen auf.
Paginierung verstehenEtwas Nützliches bauen
Nutzen Sie die zurückgegebenen Datensätze als Eingabe für Ihre eigenen Recherchen, Berichte und internen Workflows.
Suchen Sie eine Kategorie und einen Standort und organisieren Sie dann verfügbare Unternehmensnamen, Adressen, Websites, Telefonnummern und Bewertungen in Ihrer Anwendung.
Rufen Sie die öffentlichen Bewertungen eines Ortes ab, um Kundenfeedback zu untersuchen. Wählen Sie eine konsistente Sortierreihenfolge und folgen Sie den verfügbaren Seiten für Ihre Analyse.
Rufen Sie verfügbare Foto- und Video-Links für einen Ort ab. Bewahren Sie den Link zur Quellgalerie bei den Datensätzen auf, damit Ihr Team den Originalkontext prüfen kann.
Ihr Agent, verbunden
Verbinden Sie den MCP-Server für auffindbare Tools oder installieren Sie den Agent Skill für wiederverwendbare Workflow-Anweisungen und einen REST-Fallback.
Beispielaufgabe für Ihren verbundenen Agenten
„Suche eine Seite mit Cafés in Seattle. Gib die verfügbaren Namen, Websites und Bewertungen zurück und weise auf fehlende Daten hin.“
Anfragen verbrauchen Ihr API-Kontingent. Mit Test-Zugangsdaten sind die Ergebnisse simuliert.
Planen Sie Ihre Integration
Jede erfolgreiche Live-Seite, einschließlich einer leeren Seite, verbraucht eine API-Anfrage. REST und MCP teilen sich Ihren API-Tarif; Online- und Extension-Kontingente sind getrennt.
Beginnen Sie mit einer Seite, prüfen Sie die zurückgegebenen Felder und setzen Sie ein zum Endpunkt passendes Client-Timeout. Für Wiederholungen verwenden Sie denselben Idempotency-Key mit unverändertem Anfrage-Body.
Tariflimits, Ratenlimits, Quellenverfügbarkeit und Anreicherung wirken sich auf Live-Anfragen aus. Test-Zugangsdaten liefern simulierte Fixtures, ohne Ihr Live-Kontingent zu verbrauchen.
Auf den Endpunktseiten finden Sie Anfragelimits und Ergebnisfelder. Die Preisseite listet die aktuell enthaltenen Anfragen und die Raten für kostenpflichtige Überschreitungen.
G Maps Crawl bietet APIs für Unternehmenssuche, öffentliche Ortsbewertungen und Ortsfotos/-galerien. Die Suche liefert Unternehmensdatensätze; Reviews und Photos nutzen eine Maps-Feature-ID, um eine Seite für einen bestimmten Ort zurückzugeben.
Ja. Die APIs verwenden HTTP-Anfragen und JSON, sodass Sie sie mit Python, JavaScript, cURL oder einem anderen HTTP-Client aufrufen können. Jede API-Seite enthält Anfragebeispiele und eine Beispielantwort.
Die öffentlichen Search-, Reviews- und Photos-APIs liefern JSON in derselben Antwort. Sie erfordern kein Job-Polling und kein Webhook-Setup. Beachten Sie die Timeout- und Wiederholungshinweise des Endpunkts.
Mit REST ruft Ihre Anwendung einen Endpunkt direkt auf. MCP stellt einem kompatiblen KI-Client Tools zur Verfügung. Der Agent Skill liefert Workflow-Anweisungen und Hilfsskripte. REST- und MCP-Anfragen erfordern API-Zugangsdaten und verbrauchen Ihr API-Kontingent.
Verwenden Sie eine Maps-Feature-ID, die Sie bereits haben, oder kopieren Sie place.dataId aus einem passenden Datensatz im data.businesses-Array der Search API. Übergeben Sie diesen Wert als fid an die Reviews- oder Photos-API.
Nein. Die zurückgegebenen Felder hängen von der Quelle und der gewählten Operation ab. Prüfen Sie fehlende Werte und verfügbare Beobachtungszeitpunkte, bevor Sie die Daten verwenden. Eine erfolgreiche Antwort kann eine leere Seite enthalten.
Der nächste Schritt
Erstellen Sie einen API-Schlüssel, beginnen Sie mit einer Anfrage und entdecken Sie die Daten, die Ihre Anwendung nutzen kann.