API de links de avaliações do Google

Converta uma URL do Google Maps em um link direto de avaliação. Não é necessário cadastro nem chave da API do Google.

Verifique primeiro o local
A API extrai um identificador e cria um link. Ela não confirma o nome, o endereço ou a disponibilidade de avaliações.

Entrada aceita
1. Uma URL completa do Google Maps para um local específico
2. Um link de compartilhamento maps.app.goo.gl
3. Um link antigo goo.gl/maps

Encontre a URL correta do Maps
1. Abra o local exato da empresa no Google Maps.
2. Confira a unidade e o endereço e selecione Compartilhar.
3. Copie o link e envie-o como maps_url.

Solicitação
Envie um objeto JSON ao endpoint. Nomes de empresas e Place IDs isolados não são aceitos.

curl -X POST https://productmate.com/api/v1/google-review-link \
  -H "Content-Type: application/json" \
  -d '{"maps_url":"https://www.google.com/maps/place/PRODUCTMATE/data=!1s0x47b18f1cae867bab:0xb6f8b3a3753ba1a2!8m2"}'

Resposta
{
  "place_id": "ChIJq3uGrhyPsUcRoqE7daOz-LY",
  "review_url": "https://search.google.com/local/writereview?placeid=ChIJq3uGrhyPsUcRoqE7daOz-LY",
  "verification": "not_verified"
}

verification é sempre not_verified. Confira o local antes de entregar o link.

Erros e solução
- invalid_request (400): Envie JSON válido com uma maps_url não vazia.
- unsupported_url (422): Use o link Compartilhar de uma empresa específica no Google Maps.
- unsafe_redirect (422): Use um link que redirecione somente para o Google Maps.
- upstream_unresolved (502): Abra o link curto e envie a URL final completa do Maps.
- upstream_timeout (504): Aguarde, tente novamente uma vez ou envie a URL final completa do Maps.

Limites de uso
O limite anônimo é de aproximadamente 20 solicitações por minuto por IP. Agentes no mesmo IP compartilham esse limite.

Content-Length: 16 KiB
maps_url: 8 KiB
short_url_resolution_deadline: 10 s

Uma resposta 429 gerada na borda pode não ter JSON nem Retry-After. Aguarde pelo menos 60 segundos e aumente o intervalo entre tentativas.

Uso de dados
As chamadas bem-sucedidas registram o identificador do local, o idioma, o horário e a localização aproximada do estabelecimento, quando disponível. As URLs curtas resolvidas ficam em cache por 24 horas.

Coleção do Postman: https://productmate.com/developers/google-review-link/postman.json

OpenAPI: https://productmate.com/developers/google-review-link/openapi.json

Referência da API: https://productmate.com/pt-br/developers/google-review-link

Guia para agentes de IA: https://productmate.com/pt-br/agents/google-review-link

Abrir o gerador de links: https://productmate.com/pt-br/gerador-de-link-de-avaliacao-google