API de avaliações do Google: as opções gratuitas e o limite de 5 avaliações
Por Toy Wen Da, Cofundador · Atualizado em · 7 min de leitura
Traduzido do original em inglês. Ler em inglês
Uma API de avaliações do Google é a interface do próprio Google para puxar dados de avaliações por código, em vez de manualmente. O Google oferece duas: uma API do Business Profile gratuita, para os perfis que você gerencia, e uma API do Places, que lê até cinco avaliações de qualquer empresa. Escolher a errada custa uma espera por aprovação ou uma cobrança desnecessária.
Se a nota e o volume de avaliações influenciam o ranqueamento das suas unidades, o trabalho mais difícil é acompanhar esses sinais de forma consistente em todos os perfis que você gerencia. As ferramentas de SEO local do SearchBlueprint fazem isso no nível de cada unidade e combinam os dados de ranqueamento com os sinais de avaliação que o movem, para que você não precise montar o quadro a partir da saída bruta de uma API.
As duas APIs oficiais de avaliações do Google e por que as pessoas as confundem
As avaliações importam tanto que essa confusão custa dinheiro de verdade. A pesquisa de 2025 da BrightLocal com consumidores constatou que 83% dos consumidores usam o Google para ver avaliações antes de confiar em uma empresa local, e 81% olham as avaliações antes mesmo de entrar no estabelecimento. É por isso que tantos donos de site procuram uma API de avaliações e é também por isso que as duas opções oficiais decepcionam tantos deles.
API do Google Business Profile: a melhor para avaliações de perfis que você possui
A API do Google Business Profile, nome mais novo do que antes era a API do Google My Business, permite ler e responder avaliações dos locais que a sua conta gerencia. Ela retorna o texto da avaliação e a nota em estrelas, além de data e hora e de um token de paginação, com até 50 avaliações por página de resposta. O acesso é gratuito para usuários cadastrados e aprovados, mas apenas em perfis que você está verificado para gerenciar. Assim, o seu restaurante funciona, mas o de um concorrente nunca vai funcionar.
Escolha essa API se as avaliações que você quer estão nos seus próprios perfis. Deixe-a de lado se precisa de avaliações de qualquer empresa que você não gerencia.
API Google Places: a melhor para consultas rápidas em qualquer empresa
A API do Places é a que as pessoas procuram quando querem avaliações de empresas que não são delas. Ao adicionar reviews à máscara de campos (field mask) de uma requisição Place Details, você recebe o texto e as notas das avaliações de qualquer perfil público. Há um limite rígido de cinco avaliações por perfil, sem paginação e sem ordenação além do que o Google decide ser "mais relevante". Desenvolvedores pedem ao Google que elimine esse limite desde 2015 por meio do Issue Tracker público, e o pedido continua sem solução. As chamadas custam US$ 25 por 1.000 requisições Place Details, compensadas por cerca de US$ 200 de crédito mensal gratuito, o que cobre aproximadamente 8.000 chamadas antes de você começar a pagar do próprio bolso.
Escolha-a para verificações pontuais em algumas empresas. Deixe-a de lado se precisa do histórico completo de avaliações.
Como puxar ou gerenciar avaliações dentro do Google Business Profile
Para a maioria dos pequenos empresários, o caminho mais simples dispensa a API.
Como ler e responder avaliações sem API
- Entre na sua conta do Google Business Profile.
- Selecione o local que você quer gerenciar ou mude para a visualização de vários locais, se tiver mais de um.
- Abra a seção de avaliações desse local, onde cada avaliação de cliente aparece com a respectiva nota.
- Leia cada avaliação, filtre por nota em estrelas se precisar e publique uma resposta logo abaixo dela.
- Repita para cada local, porque o painel não tem botão de exportação em massa.
Como solicitar acesso à API do Business Profile para puxar dados por programação
Se você precisa que as avaliações cheguem automaticamente ao seu site ou aplicativo, vai precisar de acesso real à API:
- Crie um projeto no Google Cloud e ative nele as APIs do Business Profile.
- Confirme que o seu Business Profile está completo e verificado e que informa o site oficial da empresa.
- Envie a solicitação de acesso à API do Business Profile do Google.
- Aguarde a aprovação, que costuma levar algumas semanas e às vezes mais.
- Depois de aprovado, configure as credenciais OAuth 2.0 e chame o endpoint de listagem de avaliações do seu local autorizado.
Nosso passo a passo completo sobre o processo de acesso à API do Google Business Profile detalha a configuração do Cloud Console e os motivos mais comuns de rejeição da aprovação, se você quiser a versão passo a passo.
Quando as ferramentas do próprio Google bastam e quando não bastam
A decisão se resume a duas perguntas: quantos perfis você tem e com que frequência precisa de dados atualizados.
Se você gerencia um local, ou poucos, e só quer responder avaliações ou incorporar a sua nota em estrelas no site, a API gratuita do Business Profile ou até o painel resolvem. Não há motivo para pagar um terceiro por dados que você já consegue puxar de graça.
O caminho oficial falha em escala e na questão da propriedade. Se você precisa de avaliações de empresas que não gerencia, quer mais de cinco por perfil ou precisa atualizar os dados de avaliações de dezenas ou centenas de locais em intervalos regulares, nenhuma das APIs oficiais resolve, porque o limite de cinco avaliações da API do Places e a exigência de propriedade da API do Business Profile as descartam. A partir daí, uma opção paga de terceiros começa a fazer sentido financeiro.
Preços da API de avaliações do Google: oficial vs. terceiros
Confira as unidades antes de comparar os preços diretamente. A API do Places cobra por chamada, e cada chamada retorna no máximo cinco avaliações, então US$ 25 compram 5.000 avaliações no limite máximo. Os fornecedores terceirizados cobram por avaliação, de modo que os mesmos US$ 25 na Lobstr.io podem comprar dezenas de milhares de registros completos de avaliações.
| Opção | Preço | Acesso às avaliações | Ideal para |
|---|---|---|---|
| API do Business Profile | Grátis (exige aprovação) | Todas as avaliações, somente dos seus próprios perfis | Responder e exibir as suas próprias avaliações |
| API do Places | US$ 25 por 1.000 chamadas (~US$ 200 de crédito grátis/mês, ~8.000 chamadas) | 5 avaliações por perfil, de qualquer empresa | Consultas pontuais, verificações rápidas |
| Outscraper | ~US$ 3 por 1.000 avaliações | Ilimitado, de qualquer empresa | Filtros de consulta, controle por região |
| SerpApi | ~US$ 1,50 por 1.000 avaliações | Ilimitado, de qualquer empresa | Consultas síncronas, em tempo real |
| DataForSEO | Pague conforme o uso | Ilimitado, de qualquer empresa | Equipes que já usam o DataForSEO para dados de SEO |
| Lobstr.io | ~US$ 0,10–US$ 0,40 por 1.000 avaliações | Ilimitado, de qualquer empresa | Mais barato em escala, tarefas assíncronas |
Como fizemos a comparação
Comparamos cada opção com base nas informações públicas de preços e recursos que os fornecedores divulgam, além dos sites de avaliação e da documentação listados em Fontes. Não abrimos contas pagas nem executamos nenhuma dessas ferramentas por conta própria, então os valores acima são os divulgados, e a sua fatura pode ser diferente conforme o volume e o plano.
Erros comuns ao puxar avaliações por API
- Tratar a "API de avaliações do Google" como um único produto. São duas APIs sem relação entre si, que resolvem problemas diferentes, além de um mercado separado de terceiros.
- Esperar que a API do Places tenha paginação. Cinco avaliações é o teto, e não há como pedir mais.
- Deixar de usar marcação ao exibir no seu site as avaliações puxadas. Marque-as com os tipos Review e AggregateRating do Schema.org para que o Google possa exibir as estrelas nos resultados de busca.
- Subestimar o prazo de aprovação. Lançar um recurso dependente do acesso à API do Business Profile sem reservar algumas semanas para a aprovação é um erro comum de planejamento.
- Confundir exportação em massa com gestão de reputação. Se parte do motivo para você querer dados em massa é uma mistura de avaliações negativas genuínas e suspeitas, descubra quais avaliações o Google realmente vai remover antes de montar tudo sobre a suposição de que uma avaliação ruim pode simplesmente ser excluída.
Perguntas frequentes
Existe uma API de avaliações do Google gratuita?
Sim. A API do Google Business Profile é gratuita para usuários cadastrados e aprovados, mas só retorna avaliações dos perfis que você gerencia e não puxa avaliações de um concorrente nem de qualquer empresa que não seja sua.
Por que a API Google Places retorna só cinco avaliações?
O Google limita os resultados de avaliações do Place Details a cinco por perfil, por design. Desenvolvedores pedem mudanças desde 2015, e nenhuma correção foi lançada.
Consigo obter todas as avaliações de uma empresa que não é minha?
Não por nenhuma das APIs oficiais do Google, já que a API do Places tem limite de cinco e a API do Business Profile exige propriedade. Provedores terceirizados como Outscraper, SerpApi ou Lobstr.io são o caminho para obter o histórico completo de avaliações de empresas que você não gerencia.
Quanto tempo leva a aprovação da API do Google Business Profile?
Os prazos variam, mas algumas semanas é uma espera comum depois que você envia um Business Profile completo e verificado, junto com a solicitação de acesso.
Preciso de uma API só para responder às minhas avaliações do Google?
Não. Você pode ler e responder avaliações diretamente na sua conta do Google Business Profile, sem nenhuma configuração de desenvolvedor. A API só importa se você quiser automatizar esse processo ou incorporá-lo em outro lugar.
Escolha o ponto de partida certo
A maioria dos leitores que pesquisa "API de avaliações do Google" quer que as avaliações apareçam em outro lugar que não o site do próprio Google. Se as avaliações estão no seu próprio perfil, a API gratuita do Business Profile ou o painel resolvem sem cobrança. Se você precisa de avaliações em escala de empresas que não são suas, uma opção de terceiros é a resposta mais direta. Em qualquer caso, os dados de avaliações são mais úteis quando vinculados aos rankings locais que eles devem sustentar, que é a camada que as ferramentas de SEO local do SearchBlueprint foram criadas para acompanhar. Fale com a equipe para ver como isso funciona com os seus próprios perfis.
Fontes
Sobre o autor
O SearchBlueprint pesquisou, escreveu e avaliou este artigo com o mesmo pipeline de conteúdo que nossos clientes usam nos próprios sites. A nota que aparece na assinatura é a que nosso mecanismo de conteúdo deu a esta página antes de ela ser publicada. Nada aqui passa por revisão manual, e esse é justamente o ponto: é o resultado do produto, publicado onde qualquer pessoa pode conferir.