Panoramica di Listings API
Scopri come attivare e gestire il tuo account ListingsAPI. Le guide ti accompagnano passo passo nell’avvio dell’integrazione, mentre le guide agli endpoint coprono ogni endpoint di una risorsa. Sei nuovo? Inizia da la tua prima chiamata API.
Inizia da qui
Esegui la tua prima chiamata API
Autenticati, elenca le tue sedi, esamina la struttura della risposta, scorri le pagine dei risultati e scopri come funzionano gli ID.
Leggi la guidaScegli come integrare
Confronta l'API REST, gli SDK Python e Node, il server MCP e i webhook in base all'architettura della tua applicazione e ai requisiti di integrazione.
Leggi la guidaSedi
Consulta paesi, stati e categorie
Prima di creare una sede, trova paesi e codici stato supportati, l'ID numerico della categoria di attività e le piattaforme di pubblicazione del tuo piano.
Leggi la guidaAggiungi una sede
Crea una sede con i campi richiesti dalle piattaforme di pubblicazione, gestisci gli errori di validazione e verifica che sia in coda per l'invio.
Leggi la guidaAggiorna i dettagli e gli orari di una sede
Modifica recapiti, pubblica orari settimanali completi con eccezioni per data, indica chiusure temporanee, imposta categorie Google e rileggi le modifiche.
Leggi la guidaCarica un logo, una copertina e delle foto
Aggiungi logo, copertina e foto della galleria a una sede via URL, elenca gli allegati, segna con una stella la foto principale e rimuovi quelli obsoleti.
Leggi la guidaTrova le sedi e archivia quelle che non gestisci più
Cerca per parola chiave, risolvi codici negozio e ID in blocco, programma o annulla l'archiviazione di sedi chiuse a fine ciclo di fatturazione.
Leggi la guidaCollega le piattaforme di pubblicazione
Collega Google Business Profile e importa le tue sedi
Crea un link per collegare Google, associa le schede Google del proprietario alle tue sedi, conferma le associazioni e importa quelle ancora senza sede.
Leggi la guidaCollega le Pagine Facebook
Crea un link per collegare Facebook, abbina le Pagine del titolare alle tue sedi, conferma o scegli i link e scollega l'account quando il cliente va via.
Leggi la guidaCollega Apple Business Connect
Pubblica la sede su Apple Maps con Apple Business verificato del titolare o ListingsAPI se assente; verifica la scheda e scollega a fine rapporto.
Leggi la guidaCrea il primo Google Business Profile per una sede
Richiedi un nuovo Google Business Profile per una sede con account Google collegato e segui la verifica tramite sede, schede e webhook.
Leggi la guidaSchede
Controlla lo stato delle schede e ottieni i link attivi
Sincronizzazione e URL attivi delle schede per sede e piattaforma di pubblicazione, copertura e assistenti vocali. Ricevi webhook anziché polling.
Leggi la guidaTrova e correggi gli errori delle schede
Filtra le schede problematiche per sede, leggi il motivo della piattaforma di pubblicazione, correggi, ripeti il polling in sicurezza e verifica l’account.
Leggi la guidaTrova ed elimina le schede duplicate
Elenca le schede duplicate rilevate per sede e account, conferma quelle da rimuovere, scarta i falsi positivi e seguile fino alla risoluzione.
Leggi la guidaRecensioni
Recupera recensioni per una sede o tutto il tuo account
Elenca le ultime recensioni per sede, filtra le valutazioni basse senza risposta, scorri con cursori, esamina l'account e ricevi notifiche via webhook.
Leggi la guidaRispondi alle recensioni e modifica o archivia una risposta
Trova recensioni a cui il proprietario può rispondere, rispondi e verifica l’arrivo alla piattaforma di pubblicazione, poi modifica o archivia la risposta.
Leggi la guidaMisura le prestazioni delle recensioni
KPI delle recensioni per sede: traccia l’andamento giornaliero, confronta fonti, trova frasi comuni e ricevi sintesi quotidiane e settimanali via webhook.
Leggi la guidaPost
Analisi
Automazione
Agenti AI
Guide agli endpoint
Sedi
Endpoint sedi con esempi cURL, Python e Node in ordine d’uso: elenco, ricerca, recupero per id/codice negozio, creazione, modifica, archiviazione e foto.
Leggi la guidaSchede
Tutti gli endpoint Listings con esempi cURL, Python e Node: stato sync premium, assistenti vocali, rilevamento duplicati per sede/account e soppressione.
Leggi la guidaAccount collegati
Ogni endpoint con cURL ed esempi Python e Node: collega Google e Facebook, elenca account, abbina e collega schede, cartelle, creazione GMB, scollegamenti.
Leggi la guidaRecensioni
Tutti gli endpoint recensioni, esempi cURL/Python/Node: fonti, impostazioni, elenco, riepilogo, dettagli, risposte, modifiche, archivio, frasi e analisi.
Leggi la guidaPost
Ogni endpoint post: esempi cURL, Python e Node, annunci, eventi, offerte, pianificazione, campagne per sede e massive, polling dello stato ed eliminazione.
Leggi la guidaSocial
Endpoint Social: brand, link di connessione ospitati, pubblicazione singola e massiva, pianificazione, statistiche e limite globale di connessioni.
Leggi la guidaAnalisi
Tutti gli endpoint di analisi del profilo con esempi cURL, Python e Node: metriche Google e Facebook giornaliere e viste Bing settimanali per sede.
Leggi la guidaAPI di supporto
Ogni endpoint di supporto: esempi cURL, Python e Node; paesi e stati supportati, sottocategorie e siti delle piattaforme di pubblicazione del tuo piano.
Leggi la guida