Mit Seite 1 beginnen
Senden Sie die fid des Ortes und Seite 1. Datensätze folgen der von der Galerie des Ortes gelieferten Reihenfolge.
POST /api/v2/photos
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.
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.
{
"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
Fordern Sie Bild- und Video-Metadaten für einen einzelnen Ort über seine Feature-ID an.
| Feld | Bedeutung |
|---|---|
| fid · erforderlich | Eine 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: 1 | Eine 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
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.
| Feld | Bedeutung |
|---|---|
| photoUrl | Die verfügbare Foto-URL oder das Vorschaubild für einen Videoeintrag. |
| videoUrl | Eine optionale Video-URL. Sie ist bei Videodatensätzen vorhanden, die eine Videoquelle enthalten. |
| url | Die Google-Maps-Galerie-URL für den angefragten Ort. |
| next | Ob eine weitere nummerierte Galerieseite verfügbar ist. |
| total | Die Anzahl in dieser Antwort, von null bis 20. Dies ist nicht die Gesamtgröße der Galerie des Ortes. |
| params | Die 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
Nutzen Sie das zurückgegebene next-Flag, um zu entscheiden, ob Ihr Workflow eine weitere Anfrage benötigt.
Senden Sie die fid des Ortes und Seite 1. Datensätze folgen der von der Galerie des Ortes gelieferten Reihenfolge.
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.
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
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.
Trennen Sie Fotodatensätze von Videodatensätzen über das optionale Feld videoUrl und zeigen Sie verfügbare Vorschaubilder in Ihrer eigenen Rechercheoberfläche an.
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
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.
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.
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.
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.
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.
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.
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.
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
Erstellen Sie einen API-Schlüssel, geben Sie die Feature-ID eines Ortes an und rufen Sie strukturierte Foto- und Video-Metadaten ab.