CSV
Abre em qualquer planilha. Textos que começam com =, +, - ou @ recebem um apóstrofo no início, para que a planilha não os execute como fórmula.
Um scraper de avaliações do Google Maps lê as avaliações públicas de um ID de empresa: texto, nota, data, autor e resposta do proprietário, até 100 por página. Exporte essa página ou leia-a pela API.
Antes de começar · Pesquisas ao vivo exigem uma fonte de dados configurada. Os exemplos são identificados. Planos pagos ainda não estão disponíveis.

Um Google Maps reviews scraper, ou scraper de avaliações do Google Maps, lê as avaliações públicas de um ID de empresa: texto, nota, data, autor e resposta do proprietário, até 100 avaliações por página. Ele não pesquisa por categoria. Exporte essa página ou peça outra página com orçamento próprio.
No scraper de avaliações do Google Maps, os campos variam de uma avaliação para outra. Um campo só aparece quando a fonte de dados o retorna, e um campo vazio não prova que a informação não exista.
review_textratingreview_datetime_utcreview_timestampreview_languagereview_linkreview_photosauthor_nameauthor_linkauthor_review_countowner_response_textowner_response_datetime_utclike_countreview_idbusiness_idPesquise em “Explorar empresas”, abra uma empresa e escolha “Coleção de avaliações” em “Preparar uma tarefa de acompanhamento”. Você também pode escolher “Coleção de avaliações” e colar um ID da empresa.
Escolha a “Ordenação de avaliações”, um “Filtro de texto de avaliação” opcional e até 100 avaliações. Confira as unidades máximas e depois execute.
Abra “Páginas de resultados” para buscar as próximas páginas uma de cada vez, cada uma com seu próprio orçamento. Baixe em CSV, Excel, JSON ou JSONL, ou combine as páginas em uma exportação da cadeia completa.
Para coletar avaliações de várias empresas com o scraper de avaliações do Google Maps, selecione-as em “Explorar empresas” e escolha “Coletar avaliações da seleção em Pesquisa em massa”. Cada empresa se torna uma tarefa dentro de um único orçamento total.
No scraper de avaliações do Google Maps, crie uma tarefa de avaliações com um ID da empresa e um orçamento explícito em unidades e depois leia as avaliações página por página. Ler avaliações armazenadas nunca executa uma nova pesquisa.
Em um cliente MCP, use estimate_job, depois create_job com uma idempotency_key estável e max_units, e leia com get_job_results. Para a próxima página, preview_provider_continuation retorna a tarefa exata a ser autorizada.
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"Exemplo de resposta, resumido. Os valores são ilustrativos, não dados reais de empresas.
{
"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"
}Argumentos da ferramenta 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
}Crie uma tarefa no scraper de avaliações do Google Maps, aguarde a conclusão, leia as avaliações e depois visualize a próxima página. Enviar essa página é uma tarefa paga separada.
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"])Abre em qualquer planilha. Textos que começam com =, +, - ou @ recebem um apóstrofo no início, para que a planilha não os execute como fórmula.
Uma pasta de trabalho para Excel ou Google Planilhas, para resultados de até cerca de 5 MB. Use JSON Lines para resultados maiores.
O resultado completo, com a fonte e o horário de coleta de cada registro e a cobertura da tarefa.
Uma avaliação por linha, para arquivos grandes e pipelines de dados.
No scraper de avaliações do Google Maps, cada página de até 100 avaliações reserva uma unidade, não importa quantas avaliações retorne. Tarefas com falha, canceladas e incertas não são cobradas. Ler, exportar e combinar páginas que você já tem não usa unidades.
Uma cadeia de páginas de uma empresa para no limite de páginas do seu espaço de trabalho, 20 páginas por padrão e no máximo 100, ou quando a fonte de dados não tem próxima página.
PreçosNão. O MapsScraper.dev é um serviço independente e não é afiliado ao Google. Os resultados vêm de uma fonte de dados empresariais de terceiros e usam nosso próprio formato JSON.
O scraper de avaliações do Google Maps traz até 100 avaliações por página. Cada página adicional é uma tarefa com orçamento próprio, até que a fonte de dados não tenha próxima página ou o limite de páginas do seu espaço de trabalho seja atingido. Uma empresa pode exibir mais avaliações do que a fonte de dados retorna.
Não podemos oferecer aconselhamento jurídico. Se coletar e usar dados de empresas é lícito depende de onde você está, do que você coleta, de por que você usa esses dados e dos termos aplicáveis. A disponibilidade pública, por si só, não equivale a permissão para armazenar, revender ou entrar em contato com pessoas. Leia nossa política de dados
Explore o fluxo com exemplos identificados e conecte seu espaço para pesquisas reais.
Explorar exemplo