Guia para agentes de IA

API de link de avaliação do Google para agentes de IA

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

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.

Se a filial não estiver clara, peça ao usuário o local exato. Não adivinhe nem afirme que o resultado foi verificado.

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

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

Referência da API →

Erros e solução

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.

Erros e solução →

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.