Referência da API

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.

  1. Solicitação

    application/json { "maps_url": "https://www.google.com/maps/place/PRODUCTMATE/data=!1s0x47b18f1cae867bab:0xb6f8b3a3753ba1a2!8m2" }
  2. POST /api/v1/google-review-link productmate.com

  3. Resposta 200

    application/json { "place_id": "ChIJq3uGrhyPsUcRoqE7daOz-LY", "review_url": "https://search.google.com/local/writereview?placeid=ChIJq3uGrhyPsUcRoqE7daOz-LY", "verification": "not_verified" }
POST/api/v1/google-review-link

Entrada aceita

  • Uma URL completa do Google Maps para um local específico
  • Um link de compartilhamento maps.app.goo.gl
  • Um link antigo goo.gl/maps

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.

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.

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.