G Maps Crawl pour les développeurs

Données Google Maps.
Intégrées à votre workflow.

Recherchez des entreprises, lisez des avis publics et parcourez les photos et vidéos des lieux. Construisez avec une API REST synchrone ou donnez à votre assistant IA un accès via MCP.

JSON structuré

Résultats dans la même réponse

REST + MCP

Utilisez votre application ou client IA

Un seul quota API

Partagé entre les requêtes API et MCP

Choisissez vos données

Une API pour chaque étape de votre recherche

Commencez par une recherche d’entreprises, puis utilisez le feature ID du lieu pour demander des avis ou des éléments de galerie. Chaque API a ses propres exemples et sa référence de champs.

Votre première requête API

Passez d’une requête à des données structurées

Utilisez une clé API dans l’en-tête Authorization. Explorez les formats de requête ci-dessous, puis suivez le démarrage rapide pour effectuer votre premier appel.

Exemples de requêtes

Pour le contrat complet, consultez la documentation API.

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}'

Réponse vide illustrative. Une recherche réelle renvoie les entreprises disponibles. Gardez votre clé API côté serveur ; utilisez une nouvelle clé d’idempotence pour un nouveau travail et conservez-la pour une nouvelle tentative inchangée.

Réponse

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

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.

Construisez avec du HTTP standard

Une petite intégration. Un workflow de données utile.

01

Créer une clé API

Créez un identifiant dans votre espace de travail API et conservez-le dans la configuration secrète de votre serveur ou client. REST et MCP utilisent le même quota API.

Ouvrir les clés API
02

Choisir une API

Recherchez avec un mot-clé et un lieu. Pour les avis et photos, fournissez le feature ID Maps que vous avez déjà ou lisez place.dataId depuis un résultat de recherche.

Suivre le démarrage rapide
03

Lire la réponse JSON

Traitez la page renvoyée dans votre application. Suivez les règles de pagination de l’endpoint, inspectez les champs manquants et conservez la clé d’idempotence de la requête pour les nouvelles tentatives.

Comprendre la pagination

Construisez quelque chose d’utile

Intégrez les données Maps dans votre application

Utilisez les enregistrements renvoyés comme entrées pour vos propres recherches, rapports et workflows internes.

01

Recherche d’entreprises locales

Recherchez une catégorie et un lieu, puis organisez les noms, adresses, sites web, numéros de téléphone et notes d’entreprises disponibles dans votre application.

02

Analyse des avis

Consultez les avis publics d’un lieu pour étudier les retours clients. Choisissez un ordre de tri cohérent et parcourez les pages disponibles pour votre analyse.

03

Recherche dans la galerie d’un lieu

Récupérez les liens photo et vidéo disponibles d’un lieu. Conservez le lien de la galerie source avec les enregistrements pour que votre équipe puisse inspecter le contexte d’origine.

Votre agent, connecté

Utilisez les mêmes données via votre client IA.

Connectez le serveur MCP pour des outils découvrables, ou installez l’Agent Skill pour des instructions de workflow réutilisables et une solution REST de repli.

Tâche d’exemple pour votre agent connecté

« Recherchez une page de coffee shops à Seattle. Renvoyez les noms, sites web et notes disponibles, et signalez les données manquantes. »

Les requêtes utilisent votre quota API. Avec un identifiant de test, les résultats sont simulés.

Planifiez votre intégration

Comprenez l’utilisation avant de passer à l’échelle

Chaque page réelle réussie, y compris une page vide, utilise une requête API. REST et MCP partagent votre plan API ; les quotas Online et Extension sont séparés.

Gardez des requêtes prévisibles

Commencez avec une page, vérifiez les champs renvoyés et définissez un timeout client adapté à l’endpoint. Pour les nouvelles tentatives, réutilisez la même Idempotency-Key avec un corps de requête inchangé.

Les limites de plan, les limites de débit, la disponibilité de la source et l’enrichissement affectent les requêtes réelles. Les identifiants de test renvoient des fixtures simulées sans consommer votre quota réel.

Utilisez les pages d’endpoints pour les limites de requête et les champs de résultats. La page des tarifs liste les requêtes actuellement incluses et les tarifs de dépassement.

Questions fréquentes

Quelles API Google Maps sont disponibles ?

G Maps Crawl fournit des API de recherche d’entreprises, d’avis publics sur les lieux et de photos/galerie des lieux. La recherche renvoie des enregistrements d’entreprises ; Reviews et Photos utilisent un feature ID Maps pour renvoyer une page pour un lieu spécifique.

Puis-je utiliser Python ou JavaScript ?

Oui. Les API utilisent des requêtes HTTP et du JSON, vous pouvez donc les appeler avec Python, JavaScript, cURL ou un autre client HTTP. Chaque page d’API inclut des exemples de requêtes et un exemple de réponse.

Dois-je interroger un résultat de job ?

Les API publiques Search, Reviews et Photos renvoient du JSON dans la même réponse. Elles ne nécessitent ni polling de job ni configuration de webhook. Suivez les recommandations de timeout et de nouvelle tentative de l’endpoint.

Comment l’API, MCP et l’Agent Skill fonctionnent-ils ensemble ?

REST permet à votre application d’appeler un endpoint directement. MCP rend des outils disponibles pour un client IA compatible. L’Agent Skill fournit des instructions de workflow et des scripts d’aide. Les requêtes REST et MCP nécessitent des identifiants API et utilisent votre quota API.

Où trouver un feature ID pour les avis et photos ?

Utilisez un feature ID Maps que vous avez déjà, ou copiez place.dataId depuis un enregistrement correspondant dans le tableau data.businesses de l’API Search. Transmettez cette valeur comme fid à l’API Reviews ou Photos.

Chaque champ est-il garanti disponible ?

Non. Les champs renvoyés dépendent de la source et de l’opération sélectionnée. Inspectez les valeurs manquantes et les horodatages d’observation disponibles avant d’utiliser les données. Une réponse réussie peut contenir une page vide.

Passez à l’étape suivante

Construisez votre premier workflow de données Google Maps.

Créez une clé API, commencez par une requête et explorez les données que votre application peut utiliser.