Scraper di recensioni di Google Maps

Uno scraper di recensioni di Google Maps legge le recensioni pubbliche di un ID attività: testo, valutazione, data, autore e risposta del titolare, fino a 100 per pagina. Esporta quella pagina o leggila tramite l’API.

Prima di avviare · La ricerca dal vivo richiede una fonte di dati configurata. I dati di esempio sono identificati. I piani a pagamento non sono ancora disponibili.

Che cos’è uno scraper di recensioni di Google Maps?

Uno scraper di recensioni di Google Maps parte da un ID attività e ne legge le recensioni pubbliche: testo, valutazione, data, autore e risposta del titolare, fino a 100 recensioni per pagina. Non cerca per categoria. Esporta quella pagina, oppure richiedi la successiva con il proprio budget.

Campi di ogni recensione

I campi restituiti dallo scraper di recensioni di Google Maps variano da una recensione all’altra. Un campo compare solo quando la fonte dati lo restituisce, e un campo vuoto non dimostra che l’informazione non esista.

Come esportare le recensioni di Google Maps

  1. Scegli l’azienda

    Cerca in «Esplora aziende», apri un’azienda e scegli «Raccolta recensioni» in «Prepara un’attività successiva». Puoi anche scegliere «Raccolta recensioni» e incollare un ID attività.

  2. Imposta la pagina, poi avvia

    Scegli «Ordinamento delle recensioni», un «Filtro testo recensione» facoltativo e fino a 100 recensioni. Controlla il numero massimo di unità, poi avvia.

  3. Recupera altre pagine ed esporta

    Apri «Pagine di risultati» per recuperare le pagine successive una alla volta, ciascuna con il proprio budget. Scarica CSV, Excel, JSON o JSONL, oppure unisci le pagine in un’unica esportazione della catena completa.

Per raccogliere le recensioni di più aziende, selezionale in «Esplora aziende» e scegli «Raccogli le recensioni della selezione in Ricerca in blocco». Ogni azienda diventa un’attività entro un unico budget totale.

API dello scraper di recensioni di Google Maps

Crea un’attività di recensioni con un ID attività e un budget esplicito in unità, poi leggi le recensioni pagina per pagina. La lettura delle recensioni salvate non avvia mai una nuova ricerca.

In un client MCP, usa estimate_job, poi create_job con un idempotency_key stabile e max_units, e leggi con get_job_results. Per la pagina successiva, preview_provider_continuation restituisce l’attività esatta da autorizzare.

curl -X POST https://mapsscraper.dev/api/v1/jobs \
  -H "Authorization: Bearer $MAPSSCRAPER_API_KEY" \
  -H "Idempotency-Key: reviews-sample-business-001" \
  -H "X-Max-Units: 1" \
  -H "Content-Type: application/json" \
  -d '{"kind":"reviews","business_id":"sample-business-id","limit":100,"review_options":{"sort_by":"newest"}}'

HTTP/1.1 202 Accepted
{"id":"6f1c2b3a-0000-4000-8000-000000000000","status":"queued","reserved":1}

curl "https://mapsscraper.dev/api/v1/jobs/6f1c2b3a-0000-4000-8000-000000000000/results?offset=0&limit=100" \
  -H "Authorization: Bearer $MAPSSCRAPER_API_KEY"

Risposta di esempio, abbreviata. I valori sono illustrativi, non dati aziendali reali.

{
  "items": [
    {
      "review_id": "sample-review-id",
      "business_id": "sample-business-id",
      "review_text": "Friendly staff and a short wait.",
      "rating": 5,
      "review_language": "en",
      "author_name": "Sample Reviewer",
      "owner_response_text": "Thank you for visiting.",
      "like_count": 2,
      "_source": {
        "provider": "live_maps",
        "fetched_at": "2026-11-01T12:00:00Z"
      }
    }
  ],
  "count": 1,
  "offset": 0,
  "next_offset": null,
  "provider": "live_maps",
  "coverage": "bounded_sample",
  "fetched_at": "2026-11-01T12:00:00Z"
}

Argomenti dello strumento MCP create_job

{
  "task": {
    "kind": "reviews",
    "business_id": "sample-business-id",
    "limit": 100,
    "review_options": {
      "sort_by": "newest"
    }
  },
  "idempotency_key": "reviews-sample-business-001",
  "max_units": 1
}

Esempio in Python

Con lo scraper di recensioni di Google Maps crea un’attività di recensioni, attendi che termini, leggi le recensioni, poi visualizza l’anteprima della pagina successiva. L’invio di quella pagina è un’attività a pagamento separata.

import os
import time
import uuid

import requests

API = "https://mapsscraper.dev/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['MAPSSCRAPER_API_KEY']}"}


def run(task, units):
    # Keep the key: a retry of the same page must send it again.
    key = str(uuid.uuid4())
    job = requests.post(
        f"{API}/jobs",
        json=task,
        headers={**HEADERS, "Idempotency-Key": key, "X-Max-Units": str(units)},
        timeout=30,
    )
    job.raise_for_status()
    job_id = job.json()["id"]
    while True:
        status = requests.get(f"{API}/jobs/{job_id}", headers=HEADERS, timeout=30).json()["status"]
        if status not in ("queued", "running"):
            return job_id, status
        time.sleep(5)


task = {"kind": "reviews", "business_id": "sample-business-id", "limit": 100,
        "review_options": {"sort_by": "newest"}}
units = requests.post(f"{API}/estimate", json=task, headers=HEADERS, timeout=30).json()["units"]
job_id, status = run(task, units)

if status in ("completed", "partial"):
    page = requests.get(
        f"{API}/jobs/{job_id}/results",
        params={"offset": 0, "limit": 100},
        headers=HEADERS,
        timeout=30,
    ).json()
    for review in page["items"]:
        print(review.get("rating"), review.get("review_text"))

    # The next source page is a separate paid task: preview it, then submit
    # its exact task only if you need it.
    preview = requests.get(f"{API}/jobs/{job_id}/continuation", headers=HEADERS, timeout=30).json()
    if preview["available"]:
        run(preview["task"], preview["units"])

Formati di esportazione

CSV

Si apre in qualsiasi foglio di calcolo. Al testo che inizia con =, +, - o @ viene anteposto un apostrofo, così il foglio di calcolo non lo esegue come formula.

Excel (XLSX)

Una cartella di lavoro per Excel o Fogli Google, per risultati fino a circa 5 MB. Per risultati più grandi usa JSON Lines.

JSON

Il risultato completo con la fonte e l’ora di recupero di ogni record e la copertura dell’attività.

Righe JSON

Una recensione per riga, per file di grandi dimensioni e pipeline di dati.

Costi e limiti dello scraper di recensioni di Google Maps

Ogni pagina fino a 100 recensioni riserva un’unità, indipendentemente da quante recensioni restituisce. Le attività non riuscite, annullate e incerte non vengono addebitate. Leggere, esportare e combinare le pagine che hai già non consuma unità.

Una catena di pagine per un’azienda si ferma al limite di pagine della tua area di lavoro, 20 pagine per impostazione predefinita e al massimo 100, oppure quando la fonte dati non ha una pagina successiva.

Prezzi

Risorse

Domande sullo scraper di recensioni di Google Maps

Documentazione
È la Google Places API?

No. MapsScraper.dev è un servizio indipendente e non è affiliato a Google. I risultati provengono da una fonte di dati aziendali di terze parti e usano il nostro formato JSON.

Quante recensioni posso raccogliere per un’azienda?

Lo scraper di recensioni di Google Maps restituisce fino a 100 recensioni per pagina. Ogni pagina successiva è un’attività con il proprio budget, finché la fonte dati non ha più una pagina successiva o non si raggiunge il limite di pagine della tua area di lavoro. Un’azienda può mostrare più recensioni di quante ne restituisca la fonte dati.

È legale fare scraping di Google Maps?

Non possiamo fornire consulenza legale. La liceità della raccolta e dell’uso di dati aziendali dipende da dove ti trovi, da cosa raccogli, dal motivo per cui li usi e dai termini applicabili. La sola disponibilità pubblica non costituisce un’autorizzazione a conservare, rivendere o contattare persone. Leggi la nostra informativa sui dati

La prossima lista inizia da un luogo.

Esplora il flusso con esempi identificati e collega la tua area per ricerche reali.

Esplora un esempio