POST /api/v1/search

Google Maps-Scraper-API

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.

Anfragebeispiele

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.

Antwort

Beispielhaftes JSON
{
  "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

Von der Maps-Suche zu verwertbaren Datensätzen.

Lesen Sie data.businesses aus der Antwort. Jedes Unternehmen gruppiert seine Listing-Felder unter place; die Feldverfügbarkeit hängt von der Quelle ab.

01

Unternehmensidentität und -standort

Nutzen Sie Unternehmensname, Kategorien, formatierte Adresse, Koordinaten und Maps-URL, um einen lokalen Unternehmensdatensatz zu organisieren.

02

Kontakt und Reputation

Lesen Sie verfügbare Telefonnummern, Websites, Bewertungen und Bewertungszahlen. Mit aktiviertem extra können Sie die Anreicherung von E-Mail- und Social-Kontakten anfordern.

03

Kennungen und Beobachtungsdaten

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.

Fehlende und ältere Daten sichtbar halten

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

Wählen Sie Abfrage, Seite und Anreicherung.

Senden Sie einen JSON-Body mit Ihrem serverseitigen API-Schlüssel im Authorization-Header. Nur q ist erforderlich.

Parameter der Google Maps Search API
ParameterAnforderungZweck
qErforderlichEin Unternehmenskeyword und ein Standort, etwa Cafés in Seattle. Verwenden Sie 2–200 Zeichen.
pageStandard: 1Eine nummerierte Suchseite von 1 bis 10. Jede Anfrage liefert höchstens 20 Unternehmen.
llOptionalEin Maps-Viewport in der Form @47.6062,-122.3321,12z, um den Suchort zu steuern.
hlStandard: enDer für die Suche verwendete Sprachcode.
glOptionalEin zweistelliger Ländercode, der die Abfrage qualifiziert. Er ist kein strenger geografischer Filter.
extraStandard: falseAuf 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

Eine Anfrage. Ein nützlicher nächster Schritt.

Die Search API ist synchron: Lesen Sie das Ergebnis direkt aus der HTTP-Antwort.

01

Erstellen Sie Ihren API-Schlüssel

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 öffnen
02

Ein begrenztes Gebiet durchsuchen

Wä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.

03

Einer Ortskennung folgen

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 entdecken

Für echte Anfragen planen

Vorhersehbare Seiten, explizite Limits.

Nutzung und Verfügbarkeit

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 →

Timeouts und Wiederholungen

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

Weitere Wege, dieselben Unternehmensdaten zu nutzen.

01

Bewertungs- und Galeriedaten

Rufen Sie öffentliche Bewertungen oder Foto- und Video-Metadaten für einen Ort über seine Feature-ID ab.

Galeriedaten entdecken
02

MCP-Client verbinden

Lassen Sie einen kompatiblen KI-Client die Tools für Suche, Bewertungen und Fotos mit Ihren API-Zugangsdaten entdecken.

MCP einrichten
03

Agent Skill installieren

Geben Sie Ihrem Agenten Workflow-Anweisungen, Operationsreferenzen und einen REST-Fallback für Google-Maps-Recherchen.

Skill entdecken

Häufig gestellte Fragen

Was liefert die Google Maps-Scraper-API zurück?

Sie 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.

Kann ich die API von Python oder JavaScript aus nutzen?

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.

Wie viele Unternehmen kann eine Anfrage zurückgeben?

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.

Kann ich einzelne Bewertungen und Fotos abrufen?

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.

Sind E-Mail-Adressen für jedes Unternehmen enthalten?

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.

Wie sollte ich eine Integration testen?

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 Ihre erste Google-Maps-Suche.

Erstellen Sie einen API-Schlüssel, wählen Sie eine Abfrage und einen Standort und lesen Sie strukturierte Unternehmensdaten in derselben Antwort.