POST /api/v2/photos

API Google Maps Photos Scraper

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.

Exemples de requêtes

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.

Réponse

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

Ouvrez la galerie publique d’un lieu.

Demandez les métadonnées d’images et de vidéos d’un seul lieu avec son feature ID.

Paramètres de requête de l’API Google Maps Photos Scraper
ChampSignification
fid · requisUn 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 1Une 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

Liens photo, liens vidéo et galerie source.

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.

Champs de réponse de l’API Google Maps Photos Scraper
ChampSignification
photoUrlL’URL photo disponible, ou l’image d’aperçu pour un élément vidéo.
videoUrlUne URL vidéo optionnelle. Elle est présente pour les enregistrements vidéo qui incluent une source vidéo.
urlL’URL de la galerie Google Maps pour le lieu demandé.
nextSi une autre page de galerie numérotée est disponible.
totalLe nombre dans cette réponse, de zéro à 20. Ce n’est pas la taille totale de la galerie du lieu.
paramsLe 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

Lisez jusqu’à 20 éléments de galerie dans chaque réponse.

Utilisez le flag next renvoyé pour décider si votre workflow a besoin d’une autre requête.

01

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.

02

Inspectez la page courante

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.

03

Continuez délibérément

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

Intégrez les métadonnées de galerie dans votre workflow de recherche.

01

Recherche de fiches d’entreprises

Inspectez la galerie associée à une entreprise sélectionnée et conservez le lien de la galerie source à côté des enregistrements renvoyés.

02

Organisation des photos et vidéos

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.

03

Revue de galerie assistée par agent

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

Utilisez votre clé API pour chaque page.

Quota API partagé

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.

Voir les plans et limites API →

Gardez les nouvelles tentatives liées à la requête

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

Lire les conseils sur les erreurs et nouvelles tentatives →

Questions fréquentes

Que renvoie l’API Google Maps Photos Scraper ?

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.

Comment obtenir le feature ID de la galerie d’un 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’API Photos télécharge-t-elle des fichiers image ou vidéo ?

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.

Comment paginer une galerie Google Maps ?

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’ordre de la galerie est-il configurable ?

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.

Un agent IA peut-il récupérer les métadonnées de galerie ?

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

Explorez la galerie d’un lieu.

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.