Crei una chiave API
Crei una credenziale nella Sua area di lavoro API e la conservi nella configurazione segreta del Suo server o client. REST e MCP usano la stessa quota API.
Apra le chiavi APIG Maps Crawl per sviluppatori
Cerchi attività, legga recensioni pubbliche e sfoghi foto e video dei luoghi. Sviluppi con un'API REST sincrona o dia al Suo assistente AI l'accesso tramite MCP.
JSON strutturato
Risultati nella stessa risposta
REST + MCP
Usi la Sua applicazione o il client AI
Una quota API
Condivisa tra richieste API e MCP
Scelga i Suoi dati
Inizi con una ricerca di attività, poi usi il feature ID del luogo per richiedere recensioni o elementi della galleria. Ogni API ha i propri esempi e il riferimento dei campi.
La Sua prima richiesta API
Usi una chiave API nell'header Authorization. Esplori i formati di richiesta qui sotto, poi segua la guida rapida per effettuare la Sua prima chiamata.
Per il contratto completo, consulti la documentazione 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}'Risposta vuota illustrativa. Una ricerca live restituisce le attività disponibili. Conservi la Sua chiave API lato server; usi una nuova chiave di idempotenza per nuovo lavoro e la conservi per un retry invariato.
{
"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 restituisce JSON nella stessa risposta. Dopo un timeout, riprovi il body invariato con la stessa Idempotency-Key. Le credenziali di test restituiscono dati simulati senza usare la Sua quota live.
Sviluppi con HTTP standard
Crei una credenziale nella Sua area di lavoro API e la conservi nella configurazione segreta del Suo server o client. REST e MCP usano la stessa quota API.
Apra le chiavi APICerchi con una parola chiave e una località. Per recensioni e foto, fornisca il feature ID di Maps che già possiede o legga place.dataId da un risultato di ricerca.
Segua la guida rapidaElabori la pagina restituita nella Sua applicazione. Segua le regole di paginazione dell'endpoint, ispezioni i campi mancanti e conservi la chiave di idempotenza della richiesta per i retry.
Comprenda la paginazioneCostruisca qualcosa di utile
Usi i record restituiti come input per le Sue ricerche, report e workflow interni.
Cerchi una categoria e una località, poi organizzi nomi di attività, indirizzi, siti web, numeri di telefono e valutazioni disponibili nella Sua applicazione.
Consulti le recensioni pubbliche di un luogo per studiare il feedback dei clienti. Scelga un ordinamento coerente e segua le pagine disponibili per la Sua analisi.
Recuperi i link di foto e video disponibili per un luogo. Conservi il link della galleria di origine accanto ai record, così il Suo team potrà ispezionare il contesto originale.
Il Suo agente, connesso
Collegi il server MCP per strumenti rilevabili, oppure installi l'Agent Skill per istruzioni di workflow riutilizzabili e un fallback REST.
Attività di esempio per il Suo agente connesso
«Cerchi una pagina di caffetterie a Seattle. Restituisca nomi, siti web e valutazioni disponibili e segnali i dati mancanti.»
Le richieste usano la Sua quota API. Con una credenziale di test, i risultati sono simulati.
Pianifichi la Sua integrazione
Ogni pagina live riuscita, inclusa una pagina vuota, usa una richiesta API. REST e MCP condividono il Suo piano API; le quote Online ed Estensione sono separate.
Inizi con una pagina, controlli i campi restituiti e imposti un timeout del client appropriato per l'endpoint. Per i retry, riusi la stessa Idempotency-Key con un body di richiesta invariato.
I limiti del piano, i rate limit, la disponibilità della sorgente e l'arricchimento influiscono sulle richieste live. Le credenziali di test restituiscono fixture simulati senza consumare la Sua quota live.
Usi le pagine degli endpoint per i limiti di richiesta e i campi dei risultati. La pagina dei prezzi elenca le richieste incluse attuali e le tariffe per eccedenze a pagamento.
G Maps Crawl offre API di ricerca di attività, recensioni pubbliche di luoghi e foto/galleria di luoghi. La ricerca restituisce record di attività; Reviews e Photos usano un feature ID di Maps per restituire una pagina di un luogo specifico.
Sì. Le API usano richieste HTTP e JSON, quindi può chiamarle con Python, JavaScript, cURL o un altro client HTTP. Ogni pagina API include esempi di richiesta e una risposta di esempio.
Le API pubbliche Search, Reviews e Photos restituiscono JSON nella stessa risposta. Non richiedono polling di job né configurazione di webhook. Segua la guida su timeout e retry dell'endpoint.
REST consente alla Sua applicazione di chiamare direttamente un endpoint. MCP rende gli strumenti disponibili a un client AI compatibile. L'Agent Skill fornisce istruzioni di workflow e script di supporto. Le richieste REST e MCP richiedono credenziali API e usano la Sua quota API.
Usi un feature ID di Maps che già possiede, oppure copi place.dataId da un record corrispondente nell'array data.businesses dell'API Search. Passi quel valore come fid all'API Reviews o Photos.
No. I campi restituiti dipendono dalla sorgente e dall'operazione selezionata. Ispezioni i valori mancanti e i timestamp di osservazione disponibili prima di usare i dati. Una risposta riuscita può contenere una pagina vuota.
Faccia il passo successivo
Crei una chiave API, inizi con una richiesta ed esplori i dati che la Sua applicazione può usare.