POST /api/v2/photos

Google Maps Foto-Scraper-API

Lesen Sie bis zu 20 Galerieeinträge für einen Ort pro Seite. Erhalten Sie Foto- und Video-URLs in der Reihenfolge, in der sie in der Galerie erscheinen.

Anfragebeispiele

Den vollständigen Vertrag finden Sie in der API-Dokumentation.

curl https://gmapscrawl.com/api/v2/photos \
  -H "Authorization: Bearer $GMSCRAPER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: place-photos-page-1-example" \
  -d '{"fid":"0x89c259af336b3341:0xa4969e07ce3108de","page":1}'

Ersetzen Sie die Beispiel-fid durch die Feature-ID Ihres Ortes. Die Antwort ist simuliert; Medien-URLs auf example.com sind Platzhalter. Behalten Sie denselben Idempotenz-Schlüssel und Body bei, wenn Sie eine laufende Anfrage wiederholen.

Antwort

Beispielhaftes JSON
{
  "photos": [
    {
      "photoUrl": "https://example.com/gallery-image.jpg"
    },
    {
      "photoUrl": "https://example.com/gallery-preview.jpg",
      "videoUrl": "https://example.com/gallery-video.mp4"
    }
  ],
  "next": false,
  "total": 2,
  "url": "https://www.google.com/maps/uv?pb=!1s0x89c259af336b3341:0xa4969e07ce3108de!15sCgIgAQ",
  "params": {
    "fid": "0x89c259af336b3341:0xa4969e07ce3108de",
    "page": 1
  }
}

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.

Mit einem Ort beginnen

Öffnen Sie die öffentliche Galerie eines Ortes.

Fordern Sie Bild- und Video-Metadaten für einen einzelnen Ort über seine Feature-ID an.

Anfrageparameter der Google Maps Foto-Scraper-API
FeldBedeutung
fid · erforderlichEine Google-Maps-Feature-ID wie 0x89c259af336b3341:0xa4969e07ce3108de. Verwenden Sie place.dataId aus einem Search-API-Ergebnis oder eine Feature-ID, die Sie bereits haben.
page · Standard: 1Eine positive nummerierte Seite. Erhöhen Sie sie nur, wenn die vorherige Antwort next: true enthält.

Um eine Feature-ID zu ermitteln, suchen Sie mit der Google Maps-Scraper-API nach einem Unternehmen. Kopieren Sie place.dataId aus dem passenden Eintrag in data.businesses und übergeben Sie ihn als fid. Eine Place ID oder ein Unternehmensname ist nicht dasselbe Eingabeformat.

Galeriesätze

Fotolinks, Videolinks und die Quellgalerie.

Jeder Eintrag hat ein photoUrl für das Bild oder die Videovorschau. Videoeinträge enthalten zusätzlich ein videoUrl. Die url auf oberster Ebene verlinkt auf die Galerie des Ortes.

Antwortfelder der Google Maps Foto-Scraper-API
FeldBedeutung
photoUrlDie verfügbare Foto-URL oder das Vorschaubild für einen Videoeintrag.
videoUrlEine optionale Video-URL. Sie ist bei Videodatensätzen vorhanden, die eine Videoquelle enthalten.
urlDie Google-Maps-Galerie-URL für den angefragten Ort.
nextOb eine weitere nummerierte Galerieseite verfügbar ist.
totalDie Anzahl in dieser Antwort, von null bis 20. Dies ist nicht die Gesamtgröße der Galerie des Ortes.
paramsDie normalisierte fid und Seite, die für diese Antwort verwendet wurden.

Der Endpunkt liefert dieses Seitenobjekt direkt als JSON. Lesen Sie photos auf der obersten Ebene. Die API liefert Metadaten und Medienlinks. Die Verfügbarkeit eines Bildes oder Videos hängt von der Quelle ab; ein Galerieeintrag garantiert kein herunterladbares Video.

Eine begrenzte Seite nach der anderen

Lesen Sie bis zu 20 Galerieeinträge pro Antwort.

Nutzen Sie das zurückgegebene next-Flag, um zu entscheiden, ob Ihr Workflow eine weitere Anfrage benötigt.

01

Mit Seite 1 beginnen

Senden Sie die fid des Ortes und Seite 1. Datensätze folgen der von der Galerie des Ortes gelieferten Reihenfolge.

02

Die aktuelle Seite prüfen

total zählt die in dieser Antwort zurückgegebenen Galerieeinträge. Eine leere Seite ist ein gültiges Ergebnis. Prüfen Sie die verfügbaren Felder, bevor Sie Datensätze in Ihre Analyse aufnehmen.

03

Bewusst fortfahren

Wenn next true ist, erhöhen Sie page und behalten dieselbe fid bei. Stoppen Sie, wenn next false ist oder Ihr Workflow genügend Mediendatensätze hat.

Einen Ort visuell erkunden

Bringen Sie Galerie-Metadaten in Ihren Recherche-Workflow.

01

Recherche zu Unternehmenseinträgen

Prüfen Sie die mit einem ausgewählten Unternehmen verknüpfte Galerie und bewahren Sie den Link zur Quellgalerie neben den zurückgegebenen Datensätzen auf.

02

Foto- und Videoorganisation

Trennen Sie Fotodatensätze von Videodatensätzen über das optionale Feld videoUrl und zeigen Sie verfügbare Vorschaubilder in Ihrer eigenen Rechercheoberfläche an.

03

Agentengestützte Galerieprüfung

Lassen Sie einen verbundenen Agenten eine Seite mit Galerie-Metadaten abrufen und die verfügbaren Medienlinks für die weitere Prüfung auflisten.

Authentifizierung und Nutzung

Verwenden Sie Ihren API-Schlüssel für jede Seite.

Gemeinsames API-Kontingent

Senden Sie Authorization: Bearer mit einem Schlüssel, der scrapes:write erlaubt. Jede erfolgreiche Live-Seite, einschließlich einer leeren Seite, verbraucht eine API-Anfrageeinheit. REST und MCP nutzen dasselbe API-Kontingent. Wenn Sie Test-Zugangsdaten haben, sind deren Antworten simuliert und verbrauchen kein Live-Kontingent.

API-Tarife und -Limits ansehen →

Wiederholungen an die Anfrage binden

Senden Sie einen optionalen Idempotency-Key mit Ihrer ersten Anfrage und bewahren Sie ihn mit identischem Body für eine Timeout-Wiederholung auf. Ein Verarbeitungs-Timeout kann eine reservierte Einheit hinterlassen. Wenn ein Fehler meldet, dass der Versuch beendet ist, folgen Sie dessen Wiederholungshinweisen, bevor Sie mit einem neuen Schlüssel einen neuen Versuch starten.

Fehler- und Wiederholungshinweise lesen →

Häufig gestellte Fragen

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

Sie liefert bis zu 20 Foto- und Video-Metadatensätze für einen Ort pro JSON-Antwort. Jeder Datensatz hat ein photoUrl, und Videodatensätze können zusätzlich videoUrl enthalten. Die url auf oberster Ebene verlinkt auf die Galerie des Ortes.

Wie erhalte ich die Galerie-Feature-ID eines Ortes?

Verwenden Sie place.dataId aus einem passenden Unternehmen in einer Search-API-Antwort und senden Sie es als fid. Sie können auch eine vorhandene Maps-Feature-ID angeben. Senden Sie dieselbe fid, wenn Sie weitere Galerieseiten anfordern.

Lädt die Photos API Bild- oder Videodateien herunter?

Der Endpunkt liefert Metadaten und Medien-URLs in JSON. Ihre Anwendung kann die verfügbaren Links und die Galeriequelle prüfen. Die Quellenverfügbarkeit bestimmt, welche Datensätze und URLs zurückgegeben werden; ein photoUrl kann das Vorschaubild eines Videos sein.

Wie paginiere ich eine Google-Maps-Galerie?

Beginnen Sie mit Seite 1. total zählt die Datensätze in dieser Antwort. Wenn next true ist, fordern Sie die nächste Seite mit derselben fid und einem neuen Idempotenz-Schlüssel für die neue Anfrage an. Stoppen Sie, wenn next false ist oder Ihr Workflow genügend Datensätze hat.

Ist die Galeriereihenfolge konfigurierbar?

Die Photos API akzeptiert fid und page. Sie liefert Einträge in der von der Quelle gelieferten Galeriereihenfolge; sie bietet keinen sort_by-Parameter wie bei Bewertungen.

Kann ein KI-Agent Galerie-Metadaten abrufen?

Ja. Verbinden Sie einen kompatiblen MCP-Client, um get_google_maps_photos mit Ihren API-Zugangsdaten zu verwenden. Der Agent Skill ergänzt Workflow-Anweisungen und einen REST-Fallback. Jede erfolgreiche Live-Galerieseite verbraucht das gemeinsame API-Kontingent.

Der nächste Schritt

Erkunden Sie die Galerie eines Ortes.

Erstellen Sie einen API-Schlüssel, geben Sie die Feature-ID eines Ortes an und rufen Sie strukturierte Foto- und Video-Metadaten ab.