API di Recensioni di Google Maps
Trova le sedi delle attività, leggi le recensioni dei clienti e controlla le risposte degli esercenti tramite query di ricerca o URL dei luoghi.
Usa link che identificano un luogo specifico. Conserva gli identificativi dei luoghi restituiti per tenere separate sedi, recensioni e risposte degli esercenti.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su google_maps_reviews e action impostato sul nome di una funzionalità dell'elenco qui sotto, ad esempio search.
- 5 funzionalità
- Da $1.39 per 1.000 richieste
- Nessun addebito per chiamate non riuscite o risultati vuoti
Disponibilità della piattaforma
- Operatività nelle ultime 24 ore
- Normale
Ultimi 30 giorni
Funzionalità disponibili
Ogni azione di Recensioni di Google Maps: cosa fa, quanto costa e come ha funzionato nelle ultime 24 ore. Apri un'azione per vederne parametri, campi della risposta ed esempi di codice.
| Funzionalità | Cosa fa | Per 1.000Righe vuote: $1.39 | Operatività nelle ultime 24 ore |
|---|---|---|---|
Ricercasearch | Trova luoghi su Google Maps per un nome o un tipo di attività in keyword. | Normale | |
Dettagli del luogoprofile | Ottieni un luogo di Google Maps dal suo url completo. | Normale | |
Recensionireviews | Leggi le recensioni di un luogo di Google Maps. | Normale | |
Recensioni dei contributoricontributor_reviews | Leggi le recensioni scritte da un utente di Google Maps, dal link al profilo o dall'ID numerico in contributor. | Temporaneamente non disponibile | |
Schede delle attivitàbusiness_listings | Estrai attività da Google Maps per categoria, ad esempio dentist o coffee_shop in category, e restringile per city, country, valutazione minima o una parola nel nome dell'attività. | $15.36 per 1.000 richieste | Temporaneamente non disponibile |
Cosa accetta ogni azione di API di Recensioni di Google Maps?
Ogni risposta qui sotto associa un'azione richiamabile ai suoi input reali. Il significato dei parametri e i valori ammessi dipendono dall'azione: un nome familiare non ha lo stesso significato su tutte le piattaforme.
Le fonti ufficiali sono linkate solo per chiarire il termine della piattaforma accanto a cui compaiono. Non implicano autorizzazione o approvazione da parte della piattaforma e le funzionalità del sito ufficiale non fanno parte dell'API di EveryInfra, a meno che questa pagina non le elenchi.
Consegna Sync per ogni azione.
| Azione | Obbligatori | Facoltativi | Limite | Per 1.000Righe vuote: $1.39 | Campi della risposta |
|---|---|---|---|---|---|
searchRicerca Trova luoghi su Google Maps per un nome o un tipo di attività in | keyword | country, language, location, page_token | Valori del catalogo: defaultLimit=15, maxLimit=50. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe. Per la pagina successiva, ripassa next_page_token come page_token con gli altri parametri invariati; ogni pagina è una chiamata. Le pagine arrivano fino a 120 righe; oltre 60 righe, richiedi la pagina con mode=async. | place_id · name · url · category · categories · description · address · city · state · postal_code · country_code · lat · lng · phone · website · rating · rating_scale · review_count · price · permanently_closed · image_url · platform | |
profileDettagli del luogo Ottieni un luogo di Google Maps dal suo | url | city, language, since, sort | — | place_id · name · url · category · categories · description · address · neighborhood · city · state · postal_code · country_code · plus_code · lat · lng · phone · website · rating · rating_scale · review_count · image_count · price · permanently_closed · temporarily_closed · opening_hours · image_url · platform | |
reviewsRecensioni Leggi le recensioni di un luogo di Google Maps. Ogni recensione include valutazione, nome e numero di recensioni dell'autore, badge Local Guide, Mi piace, foto, valutazioni dettagliate ed eventuale risposta del proprietario. Scegli la lingua con | url | lang, language, page_token, since, sort | Valori del catalogo: defaultLimit=20, maxLimit=100. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe. Per la pagina successiva, ripassa next_page_token come page_token con gli altri parametri invariati; ogni pagina è una chiamata. Le pagine arrivano fino a 400 righe; oltre 200 righe, richiedi la pagina con mode=async. | id · text · rating · rating_scale · reviewer_name · reviewer_id · reviewer_review_count · is_local_guide · like_count · posted_at · url · owner_response · owner_response_at · detailed_rating · image_urls · place_id · place_name · platform | |
contributor_reviewsRecensioni dei contributori Leggi le recensioni scritte da un utente di Google Maps, dal link al profilo o dall'ID numerico in | contributor | — | Valori del catalogo: defaultLimit=20, maxLimit=200. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe. Un limit più alto è accettato e ridotto a 200. | id · text · rating · rating_scale · like_count · posted_at · posted_ago · url · image_urls · owner_response · owner_response_ago · place_name · place_address · place_type · place_data_id · lat · lng · reviewer_name · reviewer_id · reviewer_review_count · is_local_guide · local_guide_level · local_guide_points · platform | |
business_listingsSchede delle attività Estrai attività da Google Maps per categoria, ad esempio dentist o coffee_shop in | category | city, country, min_rating, name | Valori del catalogo: defaultLimit=20, maxLimit=20. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe. Un limit più alto è accettato e ridotto a 20. | $15.36 per 1.000 richieste | place_id · name · url · category · categories · description · address · city · state · postal_code · country_code · lat · lng · phone · website · rating · rating_scale · review_count · price · permanently_closed · image_url · platform |
Cosa significano i parametri search di API di Recensioni di Google Maps?
Trova luoghi su Google Maps per un nome o un tipo di attività in keyword. Ottieni ID luogo Google, indirizzo, coordinate, telefono, sito web, valutazione, numero di recensioni e stato di chiusura. Scorri le pagine con page_token, fino a 120 righe in totale. Oltre 60 righe serve la modalità asincrona.
keywordObbligatorio- Il nome di un luogo, un tipo di attività o una query su un luogo di Google Maps, ad esempio
dentistodentist in Chicago.searchtrova luoghi; non cerca nel testo delle recensioni di un'attività esistente. countryFacoltativo- Il codice del paese o della regione usato per definire il contesto della ricerca, ad esempio
us; il valore predefinito èus. Non garantisce che tutte le attività restituite si trovino in quel paese. languageFacoltativo- La lingua usata per la query o per il contenuto della pagina; il valore predefinito è
en. Per reviews, se vengono forniti entrambi,langsostituisce questo valore. Questa impostazione non garantisce che ogni recensione sia scritta in quella lingua. locationFacoltativo- Il testo del luogo combinato con
keywordpersearch, ad esempioChicago. Evita di indicare una località in conflitto con una già presente nella keyword. page_tokenFacoltativo- Token di paginazione: per ottenere la pagina successiva, ripassa il next_page_token della risposta precedente; omettilo per la prima pagina. Lascia invariati tutti gli altri parametri. I token durano 24 ore e ogni pagina corrisponde a una chiamata.
Cosa significano i parametri profile di API di Recensioni di Google Maps?
Ottieni un luogo di Google Maps dal suo url completo. Include indirizzo, plus code, coordinate, telefono, sito web, valutazione, numero di recensioni, orari di apertura e chiusura temporanea o definitiva. Usa preferibilmente l'URL restituito da search. Un link con solo nome e coordinate potrebbe non corrispondere alla stessa attività.
urlObbligatorio- Un URL completo di un luogo su Google Maps, preferibilmente quello restituito da search con
query_place_idconservato. Un URL/place/che contiene solo un nome e le coordinate potrebbe non identificare in modo affidabile la stessa attività. Usa profile per i dettagli del luogo e reviews per le sue recensioni.Google Maps: link ai luoghi e Place ID — I link di Google Maps usano `query_place_id` per identificare direttamente un luogo specifico, senza basarsi solo sul nome del luogo o sulle coordinate. · Verificato cityFacoltativo- Un vincolo sulla città per la ricerca di luoghi. Anche se l'azione profile espone questo parametro, non può spostare un'attività nota in un'altra città né sostituire in modo affidabile l'URL del luogo.
languageFacoltativo- La lingua usata per la query o per il contenuto della pagina; il valore predefinito è
en. Per reviews, se vengono forniti entrambi,langsostituisce questo valore. Questa impostazione non garantisce che ogni recensione sia scritta in quella lingua. sinceFacoltativo- Il limite inferiore della data di pubblicazione delle recensioni, preferibilmente in formato
YYYY-MM-DD. Non è la data di apertura dell'attività. La sua presenza nell'azione profile non significa che i dettagli del luogo vengano filtrati per data di apertura. sortFacoltativo- L'ordine delle recensioni:
newestper le recensioni recenti orelevanceper l'ordine di pertinenza della piattaforma. Per reviews il valore predefinito ènewest. In profile lo stesso nome può influire sui dati delle recensioni allegate, ma non ordina il singolo oggetto del luogo.Valori ammessi:newestrelevance
Cosa significano i parametri reviews di API di Recensioni di Google Maps?
Leggi le recensioni di un luogo di Google Maps. Ogni recensione include valutazione, nome e numero di recensioni dell'autore, badge Local Guide, Mi piace, foto, valutazioni dettagliate ed eventuale risposta del proprietario. Scegli la lingua con lang e scorri le pagine con page_token, fino a 400 righe. Oltre 200 righe serve la modalità asincrona.
urlObbligatorio- Un URL completo di un luogo su Google Maps, preferibilmente quello restituito da search con
query_place_idconservato. Un URL/place/che contiene solo un nome e le coordinate potrebbe non identificare in modo affidabile la stessa attività. Usa profile per i dettagli del luogo e reviews per le sue recensioni.Google Maps: link ai luoghi e Place ID — I link di Google Maps usano `query_place_id` per identificare direttamente un luogo specifico, senza basarsi solo sul nome del luogo o sulle coordinate. · Verificato langFacoltativo- L'opzione di lingua delle recensioni, ad esempio
en,zhcnozhtw; fai riferimento all'elenco completo dei valori consentiti dell'azione. Ha la precedenza sulanguage. Non filtra in base alla nazionalità dell'autore della recensione.Valori ammessi:afamarazbgbnbscacsdadeeleneses419eteufafifilfrglguhihrhuhyidisitiwjakakkkmknkokyloltlvmkmlmnmrmsmynenlnopaplptbrptptrorusiskslsqsrsvswtatethtrukuruzvizhcnzhtwzu languageFacoltativo- La lingua usata per la query o per il contenuto della pagina; il valore predefinito è
en. Per reviews, se vengono forniti entrambi,langsostituisce questo valore. Questa impostazione non garantisce che ogni recensione sia scritta in quella lingua. page_tokenFacoltativo- Token di paginazione: per ottenere la pagina successiva, ripassa il next_page_token della risposta precedente; omettilo per la prima pagina. Lascia invariati tutti gli altri parametri. I token durano 24 ore e ogni pagina corrisponde a una chiamata.
sinceFacoltativo- Il limite inferiore della data di pubblicazione delle recensioni, preferibilmente in formato
YYYY-MM-DD. Non è la data di apertura dell'attività. La sua presenza nell'azione profile non significa che i dettagli del luogo vengano filtrati per data di apertura. sortFacoltativo- L'ordine delle recensioni:
newestper le recensioni recenti orelevanceper l'ordine di pertinenza della piattaforma. Per reviews il valore predefinito ènewest. In profile lo stesso nome può influire sui dati delle recensioni allegate, ma non ordina il singolo oggetto del luogo.Valori ammessi:newestrelevance
Cosa significano i parametri contributor_reviews di API di Recensioni di Google Maps?
Leggi le recensioni scritte da un utente di Google Maps, dal link al profilo o dall'ID numerico in contributor. Ogni recensione include valutazione, testo, Mi piace, foto ed eventuale risposta del proprietario, oltre al luogo recensito (nome, indirizzo, tipo, coordinate) e al numero di recensioni e al livello Local Guide dell'autore. Le date sono relative, ad esempio 13 ore fa, in posted_ago. 20 recensioni di default, fino a 200.
contributorObbligatorio- Un recensore di Google Maps, indicato con il link al suo profilo (https://www.google.com/maps/contrib/<numeric ID>) o solo con l'ID di 10-32 cifre. I link ai recensori nei risultati di
reviewsportano a questa pagina.contributor_reviewsrestituisce fino a 200 recensioni scritte da questa persona.
Cosa significano i parametri business_listings di API di Recensioni di Google Maps?
Estrai attività da Google Maps per categoria, ad esempio dentist o coffee_shop in category, e restringile per city, country, valutazione minima o una parola nel nome dell'attività. Ogni attività include indirizzo, coordinate, telefono, sito web, valutazione e numero di recensioni. Fino a 20 attività, a partire da quelle con più recensioni; il prezzo spesso è vuoto e lo stato di chiusura non è fornito.
categoryObbligatorio- La categoria di attività di Google Maps per
business_listings, in inglese minuscolo con trattini bassi al posto degli spazi, ad esempiodentist,coffee_shopoitalian_restaurant. cityFacoltativo- Il nome di una città a cui deve corrispondere l'indirizzo dell'attività, ad esempio
Austin; le attività situate altrove vengono escluse. countryFacoltativo- Un codice paese di due lettere a cui deve corrispondere l'indirizzo dell'attività, ad esempio
usogb. min_ratingFacoltativo- La valutazione minima in stelle da mantenere in
business_listings, da 1 a 5; sono ammessi decimali come4.5. nameFacoltativo- Una parola che deve comparire nel nome dell'attività in
business_listings, ad esempio un brand; le attività che non la contengono nel nome vengono escluse.
Come usare l'API di Recensioni di Google Maps
- 01Scegli un'azione della piattaforma dal catalogo pubblico.
- 02Invia piattaforma, azione e parametri obbligatori a POST /api/v1/social.
- 03Leggi il risultato dalla risposta. Per un'azione asincrona, interroga periodicamente il job ID restituito.
- 04Salva i campi della risposta che servono alla tua applicazione.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"google_maps_reviews","action":"search","params":{"keyword":"<keyword>"}}'
Guide su API di Recensioni di Google Maps
Esempi pratici e metodi basati su queste azioni. Verifica prima azioni, parametri e campi attuali in questa pagina: esempi e limiti di un articolo non sostituiscono il catalogo aggiornato.
Deduplicare i dati dei negozi su Google Maps: il Place ID non è un'identità aziendale permanente
Lo stesso luogo può avere più Place ID e gli ID possono cambiare nel tempo. Partendo dalla documentazione ufficiale, questa guida illustra metodi di verifica per la deduplicazione dei punti vendita delle catene, la mappatura su entità interne, lo storico dei trasferimenti e le unioni errate.
Leggi l'articoloSchema per il monitoraggio della reputazione su più piattaforme: definisci l'ambito prima di valutare i peggioramenti
Progetta un flusso di monitoraggio della reputazione tracciabile partendo da elenchi di target, identità dei commenti e cursori incrementali; usa campioni offline per mostrare la deduplicazione e le lacune di acquisizione, mantenendo la revisione manuale.
Leggi l'articoloDomande sull'API di Recensioni di Google Maps
Cosa posso ottenere con l'API di Recensioni di Google Maps?
Imposta platform su google_maps_reviews. Il catalogo attuale elenca ricerca, dettagli del luogo, recensioni, recensioni dei contributori e schede delle attività. Questi nomi di azione identificano oggetti o viste diversi di Recensioni di Google Maps; non sono modalità di ricerca intercambiabili.
Quale input avvia la richiesta search di Recensioni di Google Maps?
Il nome di un luogo, un tipo di attività o una query su un luogo di Google Maps, ad esempio dentist o dentist in Chicago. search trova luoghi; non cerca nel testo delle recensioni di un'attività esistente. Invialo come keyword all'interno di params.
Quali campi può restituire search di Recensioni di Google Maps?
Il suo schema dichiarato include place_id, name, category e categories. Un campo dichiarato può comunque mancare in un singolo record, e ogni altra azione ha il proprio elenco di campi.
Tutte le azioni di Recensioni di Google Maps rispondono subito?
Le azioni indicate come asincrone restituiscono un job ID da interrogare periodicamente. Tutte le altre azioni possono essere eseguite anche in modo asincrono: aggiungi "mode": "async" al corpo della richiesta per ricevere subito un job ID, utile per task lenti o limiti elevati. Il catalogo attuale contiene consegna sync.