API linków do opinii Google

Zamień jeden adres Google Maps na bezpośredni link do opinii. Rejestracja i klucz API Google nie są wymagane.

Najpierw sprawdź lokalizację
API odczytuje identyfikator i tworzy link. Nie potwierdza nazwy firmy, adresu ani dostępności opinii.

Obsługiwane dane
1. Pełny adres Google Maps konkretnego miejsca
2. Link udostępniania maps.app.goo.gl
3. Starszy link goo.gl/maps

Znajdź właściwy adres Maps
1. Otwórz dokładną lokalizację firmy w Google Maps.
2. Sprawdź oddział i adres, a następnie wybierz Udostępnij.
3. Skopiuj link i wyślij go jako maps_url.

Żądanie
Wyślij jeden obiekt JSON do punktu końcowego. Nazwy firm i same Place ID nie są przyjmowane.

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"}'

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

verification ma zawsze wartość not_verified. Sprawdź lokalizację przed przekazaniem linku.

Błędy i rozwiązania
- invalid_request (400): Wyślij poprawny JSON z niepustym maps_url.
- unsupported_url (422): Użyj linku Udostępnij konkretnej firmy w Google Maps.
- unsafe_redirect (422): Użyj linku, który przekierowuje wyłącznie do Google Maps.
- upstream_unresolved (502): Otwórz krótki link i wyślij jego pełny końcowy adres Maps.
- upstream_timeout (504): Poczekaj, spróbuj raz ponownie lub wyślij pełny końcowy adres Maps.

Limity użycia
Anonimowy limit wynosi około 20 żądań na minutę dla jednego adresu IP. Agenci korzystający ze wspólnego IP dzielą ten limit.

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

Odpowiedź 429 z warstwy brzegowej może nie zawierać JSON ani nagłówka Retry-After. Poczekaj co najmniej 60 sekund, a potem zwiększaj czas oczekiwania.

Wykorzystanie danych
Udane wywołania zapisują identyfikator miejsca, język, czas i przybliżoną lokalizację firmy, jeśli jest dostępna. Rozwinięte krótkie adresy URL są przechowywane w pamięci podręcznej przez 24 godziny.

Kolekcja Postman: https://productmate.com/developers/google-review-link/postman.json

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

Dokumentacja API: https://productmate.com/pl/developers/google-review-link

Przewodnik dla agentów AI: https://productmate.com/pl/agents/google-review-link

Otwórz generator linków: https://productmate.com/pl/generator-linku-do-opinii-google