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 APIG Maps Crawl pour les développeurs
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
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
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.
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.
{
"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
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 APIRecherchez 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 rapideTraitez 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 paginationConstruisez quelque chose d’utile
Utilisez les enregistrements renvoyés comme entrées pour vos propres recherches, rapports et workflows internes.
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.
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.
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é
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
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.
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.
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.
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.
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.
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.
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.
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
Créez une clé API, commencez par une requête et explorez les données que votre application peut utiliser.