Unternehmensidentität und -standort
Nutzen Sie Unternehmensname, Kategorien, formatierte Adresse, Koordinaten und Maps-URL, um einen lokalen Unternehmensdatensatz zu organisieren.
POST /api/v1/search
Finden Sie Unternehmen nach Keyword und Standort. Erhalten Sie bis zu 20 strukturierte Unternehmensdatensätze in derselben JSON-Antwort – bereit für Ihre Anwendung oder Ihren Recherche-Workflow.
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.
Strukturierte Unternehmensdaten
Lesen Sie data.businesses aus der Antwort. Jedes Unternehmen gruppiert seine Listing-Felder unter place; die Feldverfügbarkeit hängt von der Quelle ab.
Nutzen Sie Unternehmensname, Kategorien, formatierte Adresse, Koordinaten und Maps-URL, um einen lokalen Unternehmensdatensatz zu organisieren.
Lesen Sie verfügbare Telefonnummern, Websites, Bewertungen und Bewertungszahlen. Mit aktiviertem extra können Sie die Anreicherung von E-Mail- und Social-Kontakten anfordern.
Bewahren Sie place.dataId für Bewertungs- und Fotoabfragen auf. Prüfen Sie place.observedAt und contactsCheckedAt, um zu verstehen, wann die Daten erhoben wurden.
Nicht verfügbare Felder können null oder leer sein, und die Anreicherung kann not_found oder failed melden. Ein Datensatz garantiert nicht, dass eine E-Mail-Adresse oder Website existiert. Maps-Details können bis zu 730 Tage mit ihren ursprünglichen Beobachtungszeitpunkten wiederverwendet werden; bewerten Sie die Aktualität, bevor Sie einen Datensatz verwenden.
Mehr über Datenaktualität →Eine fokussierte Anfrage
Senden Sie einen JSON-Body mit Ihrem serverseitigen API-Schlüssel im Authorization-Header. Nur q ist erforderlich.
| Parameter | Anforderung | Zweck |
|---|---|---|
| q | Erforderlich | Ein Unternehmenskeyword und ein Standort, etwa Cafés in Seattle. Verwenden Sie 2–200 Zeichen. |
| page | Standard: 1 | Eine nummerierte Suchseite von 1 bis 10. Jede Anfrage liefert höchstens 20 Unternehmen. |
| ll | Optional | Ein Maps-Viewport in der Form @47.6062,-122.3321,12z, um den Suchort zu steuern. |
| hl | Standard: en | Der für die Suche verwendete Sprachcode. |
| gl | Optional | Ein zweistelliger Ländercode, der die Abfrage qualifiziert. Er ist kein strenger geografischer Filter. |
| extra | Standard: false | Auf true setzen, um verfügbare E-Mail- und Social-Kontaktanreicherung anzufordern. Das kann länger dauern. |
Die Antwort spiegelt normalisierte Parameter in data.params wider. Der Wert data.total zählt die Unternehmen in dieser Antwort, nicht die Gesamtzahl der Unternehmen auf Google Maps. Wählen Sie explizit eine andere Seite, wenn Ihr Workflow mehr Ergebnisse benötigt.
Erstellen Sie Ihre erste Integration
Die Search API ist synchron: Lesen Sie das Ergebnis direkt aus der HTTP-Antwort.
Nutzen Sie Ihren API-Workspace, um einen Schlüssel mit der Berechtigung scrapes:write zu erstellen. Speichern Sie den Schlüssel in Ihrer Serverumgebung und senden Sie Authorization: Bearer mit der Anfrage.
API-Schlüssel öffnenWählen Sie eine Kategorie und einen Standort, fordern Sie Seite 1 an und prüfen Sie die zurückgegebenen Listing-Felder. Für einen Marktvergleich stellen Sie separate Suchen für die Gebiete, die Sie vergleichen möchten.
Verwenden Sie place.dataId eines passenden Unternehmens als fid, um eine Bewertungsseite oder Galerieseite abzurufen. Dies sind separate Anfragen mit eigenen zurückgegebenen Datensätzen.
Reviews API entdeckenFür echte Anfragen planen
Jede erfolgreiche Live-Suchseite verbraucht eine API-Anfrageeinheit, einschließlich eines leeren Ergebnisses. REST und MCP teilen sich das API-Kontingent. Online-Scraper- und Extension-Abos haben getrennte Kontingente. Ratenlimits, Zugangsdaten, Dienstkapazität und Quellenverfügbarkeit gelten weiterhin.
API-Tarife vergleichen →Planen Sie in Ihrem HTTP-Client bis zu 180 Sekunden ein. Ein Timeout kann eine laufende Verarbeitung mit reservierter Anfrageeinheit hinterlassen. Verwenden Sie denselben Body und Idempotency-Key, um diese Anfrage zu wiederholen. Prüfen Sie Fehlerdetails und Wiederholbarkeit, bevor Sie einen neuen Versuch starten.
Wiederholungen verstehen →Setzen Sie Ihren Workflow fort
Rufen Sie öffentliche Bewertungen oder Foto- und Video-Metadaten für einen Ort über seine Feature-ID ab.
Galeriedaten entdeckenLassen Sie einen kompatiblen KI-Client die Tools für Suche, Bewertungen und Fotos mit Ihren API-Zugangsdaten entdecken.
MCP einrichtenGeben Sie Ihrem Agenten Workflow-Anweisungen, Operationsreferenzen und einen REST-Fallback für Google-Maps-Recherchen.
Skill entdeckenSie liefert eine JSON-Hülle mit data.businesses, data.total, normalisierten data.params, request_id und schema_version. Unternehmen enthalten verfügbare Listing-Felder wie Namen, Adressen, Kategorien, Kontaktinformationen, Bewertungen und Maps-Kennungen.
Ja. Der Endpunkt akzeptiert standardmäßige HTTP-POST-Anfragen mit JSON und Bearer-Authentifizierung. Die obigen Beispiele verwenden Pythons Standardbibliothek und serverseitiges JavaScript-fetch. Jeder HTTP-Client, der diese Header und diesen Body senden kann, kann integriert werden.
Eine Suchseite liefert zwischen null und 20 Unternehmen. Der Parameter page akzeptiert 1 bis 10. Jede erfolgreiche Live-Seite, einschließlich einer leeren Seite, verbraucht eine API-Anfrageeinheit; eine Suche garantiert nicht, dass jede Seite 20 Unternehmen enthält.
Ja. Kopieren Sie place.dataId aus einem Unternehmen und übergeben Sie es als fid an die separate Reviews- oder Photos-API. Diese Endpunkte liefern eine begrenzte Seite pro Anfrage. Die API-Übersicht verlinkt auf Felder, Beispiele und Paginierungsregeln jedes Endpunkts.
Nein. Setzen Sie extra auf true, um verfügbare Kontaktanreicherung anzufordern. Websites, E-Mails und Social-Media-Profile können fehlen. Prüfen Sie enrichmentState und fieldStates und halten Sie nicht verfügbare Daten in Ihrer Anwendung explizit.
Wenn Sie Test-Zugangsdaten haben, sind deren Antworten simuliert und verbrauchen kein Live-API-Kontingent. Kennzeichnen Sie diese Ergebnisse als simuliert. Live-Schlüssel erfordern eine aktive API-Berechtigung und verfügbare Dienstkapazität, und erfolgreiche Live-Aufrufe verbrauchen Anfrageeinheiten.
Der nächste Schritt
Erstellen Sie einen API-Schlüssel, wählen Sie eine Abfrage und einen Standort und lesen Sie strukturierte Unternehmensdaten in derselben Antwort.