Commencez par la page 1
Envoyez le fid du lieu et la page 1. Les enregistrements suivent l’ordre fourni par la galerie du lieu.
POST /api/v2/photos
Lisez jusqu’à 20 éléments de galerie pour un lieu par page. Obtenez les URL de photos et vidéos dans l’ordre où elles apparaissent dans la galerie.
Pour le contrat complet, consultez la documentation API.
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}'Remplacez le fid d’exemple par le feature ID de votre lieu. La réponse est simulée ; les URL de médias example.com sont des placeholders. Gardez la même clé d’idempotence et le même corps lors d’une nouvelle tentative d’une requête en cours.
{
"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
}
}L’API renvoie du JSON dans la même réponse. Après un timeout, réessayez avec le corps inchangé et la même Idempotency-Key. Les identifiants de test renvoient des données simulées sans consommer votre quota réel.
Commencez par un lieu
Demandez les métadonnées d’images et de vidéos d’un seul lieu avec son feature ID.
| Champ | Signification |
|---|---|
| fid · requis | Un feature ID Google Maps, comme 0x89c259af336b3341:0xa4969e07ce3108de. Utilisez place.dataId d’un résultat de l’API Search, ou un feature ID que vous avez déjà. |
| page · par défaut 1 | Une page numérotée positive. Ne l’augmentez que lorsque la réponse précédente a next: true. |
Pour découvrir un feature ID, recherchez une entreprise avec l’API Google Maps Scraper. Copiez place.dataId depuis l’entrée correspondante dans data.businesses et transmettez-le comme fid. Un place ID ou un nom d’entreprise n’est pas le même format d’entrée.
Enregistrements de galerie
Chaque élément a un photoUrl pour l’image ou l’aperçu vidéo. Les éléments vidéo incluent aussi un videoUrl. L’url de niveau supérieur renvoie vers la galerie du lieu.
| Champ | Signification |
|---|---|
| photoUrl | L’URL photo disponible, ou l’image d’aperçu pour un élément vidéo. |
| videoUrl | Une URL vidéo optionnelle. Elle est présente pour les enregistrements vidéo qui incluent une source vidéo. |
| url | L’URL de la galerie Google Maps pour le lieu demandé. |
| next | Si une autre page de galerie numérotée est disponible. |
| total | Le nombre dans cette réponse, de zéro à 20. Ce n’est pas la taille totale de la galerie du lieu. |
| params | Le fid et la page normalisés utilisés pour cette réponse. |
L’endpoint renvoie directement cet objet page en JSON. Lisez photos au niveau supérieur. L’API renvoie des métadonnées et des liens médias. La disponibilité d’une image ou vidéo dépend de la source ; un élément de galerie ne garantit pas une vidéo téléchargeable.
Une page bornée à la fois
Utilisez le flag next renvoyé pour décider si votre workflow a besoin d’une autre requête.
Envoyez le fid du lieu et la page 1. Les enregistrements suivent l’ordre fourni par la galerie du lieu.
total compte les éléments de galerie renvoyés dans cette réponse. Une page vide est un résultat valide. Vérifiez les champs disponibles avant d’ajouter des enregistrements à votre analyse.
Quand next est true, incrémentez page et gardez le même fid. Arrêtez quand next est false, ou quand votre workflow a assez d’enregistrements médias.
Explorez un lieu visuellement
Inspectez la galerie associée à une entreprise sélectionnée et conservez le lien de la galerie source à côté des enregistrements renvoyés.
Séparez les enregistrements photo des enregistrements vidéo avec le champ optionnel videoUrl, et présentez les images d’aperçu disponibles dans votre propre interface de recherche.
Laissez un agent connecté récupérer une page de métadonnées de galerie et lister les liens médias disponibles pour une inspection ultérieure.
Authentification et utilisation
Envoyez Authorization: Bearer avec une clé autorisant scrapes:write. Chaque page réelle réussie, y compris une page vide, utilise une unité de requête API. REST et MCP utilisent le même quota API. Si vous avez un identifiant de test, ses réponses sont simulées et ne consomment pas de quota réel.
Envoyez une Idempotency-Key optionnelle avec votre première requête et conservez-la avec un corps identique pour une nouvelle tentative après timeout. Un timeout de traitement peut laisser une unité réservée. Si une erreur indique que la tentative est terminée, suivez ses conseils de nouvelle tentative avant de créer une nouvelle tentative avec une nouvelle clé.
Elle renvoie jusqu’à 20 enregistrements de métadonnées photo et vidéo pour un lieu dans chaque réponse JSON. Chaque enregistrement a un photoUrl, et les enregistrements vidéo peuvent aussi inclure videoUrl. L’url de niveau supérieur renvoie vers la galerie du lieu.
Utilisez place.dataId d’une entreprise correspondante dans une réponse de l’API Search et envoyez-le comme fid. Vous pouvez aussi fournir un feature ID Maps existant. Envoyez le même fid quand vous demandez d’autres pages de galerie.
L’endpoint renvoie des métadonnées et des URL de médias en JSON. Votre application peut inspecter les liens disponibles et la galerie source. La disponibilité à la source détermine quels enregistrements et URL sont renvoyés ; un photoUrl peut être l’image d’aperçu d’une vidéo.
Commencez par la page 1. total compte les enregistrements dans cette réponse. Si next est true, demandez la page suivante avec le même fid et une nouvelle clé d’idempotence pour la nouvelle requête. Arrêtez quand next est false ou que votre workflow a assez d’enregistrements.
L’API Photos prend fid et page. Elle renvoie les éléments dans l’ordre de la galerie fourni par la source ; elle n’expose pas de paramètre sort_by comme les avis.
Oui. Connectez un client MCP compatible pour utiliser get_google_maps_photos avec vos identifiants API. L’Agent Skill ajoute des instructions de workflow et une solution REST de repli. Chaque page de galerie réelle réussie utilise le quota API partagé.
Passez à l’étape suivante
Créez une clé API, fournissez le feature ID d’un lieu et récupérez des métadonnées photo et vidéo structurées.