Cosa vale un credito
| Tipo di job | Un credito | Dettaglio importante |
|---|---|---|
| Lead | Una riga di attività Google Maps restituita | L’arricchimento di email e social non ha un addebito a parte |
| Recensioni | Una riga di recensione raccolta | Il luogo selezionato non è un credito recensioni extra |
| Foto | Un URL foto univoco | Gli URL duplicati vengono rimossi prima dell’addebito |
Crediti mensili, crediti gratuiti e pacchetti permanenti
- I crediti iniziali gratuiti sono una dotazione a vita: non si rinnovano ogni mese.
- I crediti in abbonamento si ricaricano a ogni ciclo di fatturazione e quelli mensili non usati non si riportano.
- I pacchetti di crediti permanenti non scadono e restano disponibili accanto a un account idoneo.
- Gli account con soli pacchetti hanno le funzioni Online del livello Starter; API Agent e MCP richiedono comunque Growth o superiore.
Dotazioni dei piani e dimensioni dei pacchetti sono sui prezzi. Acquistare un pacchetto cambia il saldo permanente disponibile, non le regole di rinnovo mensile.
Un solo job Maps in esecuzione per account
Lead, recensioni e foto condividono un blocco «in corso» tra interfaccia Online, MCP e API HTTP. Completa il job attivo, attendi che fallisca oppure annullalo prima di avviarne un altro. Una richiesta concorrente restituisce HTTP 409.
- Crea un job.
- Controlla lo stato fino a completato, parziale o non riuscito.
- Scarica ogni pagina di risultati.
- Avvia la parola chiave o il luogo successivo solo quando il job precedente ha raggiunto uno stato finale.
Lotti web e richieste Agent e API
| Superficie | Regola di input | Ideale per |
|---|---|---|
| Interfaccia web Online | Un elenco di parole chiave o luoghi, secondo il piano, in coda in sequenza | Revisione visiva e download CSV |
| MCP / HTTP lead | Esattamente una parola chiave per richiesta di creazione job | Chat con agent, script e integrazioni |
| MCP / HTTP recensioni o foto | Esattamente un luogo per richiesta di creazione job | Automazione sequenziale dei luoghi |
Per autenticazione API, polling, paginazione e codici di stato, usa il manuale Agent e il riferimento API HTTP.
Le quote Online e dell’estensione Chrome sono separate
I job web Online, MCP e HTTP usano l’account Online e il suo monte crediti condiviso. I prodotti Chrome hanno piani e quote propri; l’uso dell’estensione non attinge al monte Online.
- Google Maps Extractor è il flusso Chrome in blocco sulla mappa e si installa con lo ZIP ufficiale.
- Google Maps Leads Finder è il flusso a singolo luogo sul Chrome Web Store.
- Online Google Maps Extractor è il flusso cloud per lotti di parole chiave, cronologia, zip CSV e accesso Agent.
Errori di credito e di accesso
| Stato | Significato | Prossimo passo |
|---|---|---|
| 401 | Chiave API assente o non valida | Controlla la chiave Bearer in Account |
| 402 | Non restano crediti utilizzabili | Attendi il rinnovo, compra un pacchetto o passa a un piano superiore |
| 403 | Il piano non include l’API Agent | Usa Online oppure scegli Growth+ |
| 409 | È già in esecuzione un altro job Maps | Attendi che il job attuale finisca |