🗺️ Google Maps BR Scraper — Business Data + Reviews (Brazil)

🔗 View on Apify Store | 🇺🇸 English | 🇧🇷 Português

Scrape Google Maps businesses in Brazil with full details, reviews, ratings, and CEP enrichment. Search by keyword + city, extract business information, and collect customer reviews with sentiment analysis.

✨ Features

• 🔍 Search by keyword + city — "restaurantes São Paulo", "dentista Curitiba"
• 📋 Full business data — Name, address, phone, rating, category, price level
• ⭐ Review extraction — Best-effort extraction of author, rating, text, date (see Limitations)
• 💬 Sentiment analysis — Score (-1.0 to 1.0) + label per review
• 📮 CEP enrichment — Validates CEP via ViaCEP API
• 🛡️ Validated output — Every output validated before delivery
• 🌐 Portuguese optimized — Interface language pt-BR by default
• 💰 Low cost — $0.003/review, 100 free results

📥 Input

Parameter	Type	Required	Default	Description
queries	string[]	✅	—	Search queries ("keyword + city")
maxPlaces	integer	❌	10	Max businesses per query
maxReviews	integer	❌	5	Max reviews per business (0 = none)
language	string	❌	"pt-BR"	Interface language
enrichCep	boolean	❌	true	Validate CEP via ViaCEP
proxyConfig	object	❌	Apify Proxy	Proxy settings

Input Example

{
  "queries": [
    "restaurantes São Paulo",
    "dentista Curitiba",
    "hotel Rio de Janeiro"
  ],
  "maxPlaces": 10,
  "maxReviews": 5,
  "language": "pt-BR",
  "enrichCep": true
}

📤 Output

Every business includes these fields:

Field	Type	Description
business_name	string	Business name
place_id	string	Google Maps Place ID
address	string	Full address
cep	string	Brazilian postal code (CEP)
phone	string	Phone number
rating	number	Google rating (1.0-5.0)
total_reviews	number	Total review count
category	string	Business category
price_level	string	Price level ($, $$, $$$)
url	string	Google Maps URL
website	string	Business website
reviews	object[]	Extracted reviews (see below)

Review Fields

Field	Type	Description
author	string	Reviewer name
rating	number	Review rating (1-5)
text	string	Review text
date	string	Review date
sentiment_score	number	Sentiment score (-1.0 to 1.0)
sentiment_label	string	muito_positivo / positivo / neutro / negativo / muito_negativo
language	string	Detected language (pt-BR, en)
topics	string[]	Detected topics (comida, atendimento, preço, etc.)

Output Example

{
  "business_name": "A Casa do Porco Bar",
  "place_id": "ChIJYYCw_9VZzpQRKTNZNbdkVME",
  "address": "R. Araújo, 124 - República, São Paulo - SP, 01220-020",
  "cep": "01220020",
  "phone": "(11) 3258-2578",
  "rating": 4.7,
  "total_reviews": 18542,
  "category": "Restaurante brasileiro",
  "price_level": "$$$",
  "url": "https://www.google.com/maps/place/...",
  "reviews": [
    {
      "author": "João Silva",
      "rating": 5,
      "text": "Melhor restaurante de porco de São Paulo!",
      "date": "1 mês atrás",
      "sentiment_score": 1.0,
      "sentiment_label": "muito_positivo",
      "language": "pt-BR",
      "topics": ["comida"]
    }
  ]
}

📋 Use Cases

• Market Research — Map competitors in a city by category
• Reputation Monitoring — Track reviews and ratings over time
• Lead Generation — Extract business contact info (phone, address)
• Location Analysis — Compare ratings across neighborhoods
• Customer Insights — Analyze review topics and sentiment

⚠️ Limitations

• Review text extraction is best-effort. Google Maps actively blocks automated review extraction with aggressive anti-bot measures. Business data (name, address, phone, rating, total review count, category) is extracted reliably. Individual review text may not always be available.
• Total review count is always extracted from the business page (e.g., "18,542 reviews") even when individual review text cannot be retrieved.
• Geographic entities (cities, states) that appear in search results are automatically filtered out.

❓ FAQ

Q: Does this need a Google API key? A: No! This actor works without any Google API credentials.

Q: What proxy does it need? A: Residential proxy is used by default for best results against Google anti-bot.

Q: Can I search in any Brazilian city? A: Yes! Just use the format "keyword + city name" in your queries.

Q: Why are reviews sometimes empty? A: Google Maps uses aggressive anti-bot measures that strip review content from automated browsers. Business data and total review counts are always extracted reliably.

Q: What sentiment labels are available? A: Five levels from muito_positivo to muito_negativo, based on review context.

Q: Does it extract CEP for every business? A: Yes, when enrichCep is enabled. The CEP is validated via the ViaCEP public API.

💰 Pricing

This actor uses Pay Per Event (PPE) pricing:

Metric	Cost
Per business scraped	$0.003
Free tier	100 results/month

💡 Try it free — first 100 results every month at no cost!

�🔗 Related Actors

• CNPJ Enricher — Enrich with company data
• YouTube Fast Scraper — YouTube video metrics
• TikTok Viral Scanner — TikTok profile data
• Instagram Reels Scraper — Instagram metrics

📝 Changelog

v1.0 (Current)

• ✅ Search by keyword + city
• ✅ Full business data extraction (name, address, phone, rating, total reviews, category)
• ✅ Best-effort review extraction with sentiment analysis
• ✅ CEP enrichment via ViaCEP
• ✅ Geographic entity filtering (skips cities/states)
• ✅ Stealth browsing with residential proxy
• ✅ Bilingual support (PT-BR + EN)

---

🗺️ Google Maps BR Scraper — Dados de Empresas + Avaliações

🇺🇸 English | 🇧🇷 Português

Extraia dados de empresas do Google Maps no Brasil com detalhes completos, avaliações, notas e enriquecimento de CEP. Busque por palavra-chave + cidade, extraia informações do negócio e colete avaliações de clientes com análise de sentimento.

✨ Funcionalidades

• 🔍 Busca por palavra-chave + cidade — "restaurantes São Paulo", "dentista Curitiba"
• 📋 Dados completos — Nome, endereço, telefone, nota, categoria, faixa de preço
• ⭐ Extração de avaliações — Extração best-effort de autor, nota, texto, data (veja Limitações)
• 💬 Análise de sentimento — Score (-1.0 a 1.0) + label por avaliação
• 📮 Enriquecimento de CEP — Validação via API ViaCEP
• 🛡️ Output validado — Todo output validado antes da entrega
• 🌐 Otimizado para português — Interface pt-BR por padrão
• 💰 Custo baixo — $0.003/avaliação, 100 grátis

📥 Entrada

Parâmetro	Tipo	Obrigatório	Padrão	Descrição
queries	string[]	✅	—	Buscas ("palavra-chave + cidade")
maxPlaces	inteiro	❌	10	Máx empresas por busca
maxReviews	inteiro	❌	5	Máx avaliações por empresa (0 = nenhuma)
language	string	❌	"pt-BR"	Idioma da interface
enrichCep	boolean	❌	true	Validar CEP via ViaCEP
proxyConfig	objeto	❌	Apify Proxy	Config de proxy

Exemplo de Entrada

{
  "queries": [
    "restaurantes São Paulo",
    "dentista Curitiba",
    "hotel Rio de Janeiro"
  ],
  "maxPlaces": 10,
  "maxReviews": 5,
  "language": "pt-BR",
  "enrichCep": true
}

📤 Saída

Cada empresa inclui estes campos:

Campo	Tipo	Descrição
business_name	string	Nome da empresa
place_id	string	Google Maps Place ID
address	string	Endereço completo
cep	string	CEP (código postal)
phone	string	Telefone
rating	número	Nota Google (1.0-5.0)
total_reviews	número	Total de avaliações
category	string	Categoria da empresa
price_level	string	Faixa de preço ($, $$, $$$)
url	string	URL do Google Maps
website	string	Site da empresa
reviews	objeto[]	Avaliações extraídas (ver abaixo)

Campos da Avaliação

Campo	Tipo	Descrição
author	string	Nome do avaliador
rating	número	Nota (1-5)
text	string	Texto da avaliação
date	string	Data
sentiment_score	número	Score de sentimento (-1.0 a 1.0)
sentiment_label	string	muito_positivo / positivo / neutro / negativo / muito_negativo
language	string	Idioma detectado (pt-BR, en)
topics	string[]	Tópicos detectados (comida, atendimento, preço, etc.)

📋 Casos de Uso

• Pesquisa de mercado — Mapeie concorrentes por cidade e categoria
• Monitoramento de reputação — Acompanhe avaliações e notas ao longo do tempo
• Geração de leads — Extraia contatos (telefone, endereço)
• Análise de localização — Compare notas entre bairros
• Insights de clientes — Analise tópicos e sentimento das avaliações

⚠️ Limitações

• Extração de texto de avaliações é best-effort. O Google Maps bloqueia ativamente a extração automatizada de avaliações com medidas anti-bot agressivas. Dados de negócios (nome, endereço, telefone, nota, total de avaliações, categoria) são extraídos de forma confiável.
• Contagem total de avaliações é sempre extraída da página da empresa, mesmo quando o texto individual não está disponível.
• Entidades geográficas (cidades, estados) que aparecem nos resultados são filtradas automaticamente.

❓ Perguntas Frequentes

P: Precisa de chave da API do Google? R: Não! Este actor funciona sem nenhuma credencial de API do Google.

P: Que tipo de proxy precisa? R: Proxy residencial é usado por padrão para melhores resultados contra anti-bot do Google.

P: Posso buscar em qualquer cidade brasileira? R: Sim! Use o formato "palavra-chave + nome da cidade" nas queries.

P: Por que as avaliações às vezes estão vazias? R: O Google Maps usa medidas anti-bot agressivas que removem conteúdo de avaliações de navegadores automatizados. Dados do negócio e contagens totais são sempre extraídos.

P: Quais labels de sentimento estão disponíveis? R: Cinco níveis de muito_positivo a muito_negativo, baseados no contexto da avaliação.

P: O CEP é extraído para toda empresa? R: Sim, quando enrichCep está habilitado. O CEP é validado via API pública ViaCEP.

💰 Preços

Este actor usa precificação Pay Per Event (PPE):

Métrica	Custo
Por empresa extraída	$0.003
Tier gratuito	100 resultados/mês

💡 Teste grátis — primeiros 100 resultados todo mês sem custo!

�🔗 Actors Relacionados

• CNPJ Enricher — Enriquecimento com dados empresariais
• YouTube Fast Scraper — Métricas do YouTube
• TikTok Viral Scanner — Dados do TikTok
• Instagram Reels Scraper — Métricas do Instagram