Social Profiles

Consulta i profili social (Pagine Facebook, Instagram, LinkedIn, …) collegati al tuo account.

📄️List connected social profiles

Restituisce tutti i profili social attualmente collegati al tuo account. Un profilo social rappresenta una connessione autenticata a una piattaforma esterna come Facebook, Instagram, LinkedIn, Google o TikTok. I profili vengono collegati tramite il flusso OAuth della piattaforma nella dashboard web e non possono essere collegati tramite questa API. Ogni voce della risposta include il nome della piattaforma, lo username, il nome del profilo, l'URL dell'immagine del profilo, la data di connessione, un flag disconnected che indica se la connessione non è più valida e il numero di pagine o sotto-account collegati. Per ottenere i dettagli completi di una piattaforma specifica, incluse tutte le pagine e i sotto-account collegati, chiama GET /socials/{platform} con il nome della piattaforma (es. facebook, instagram, linkedin, google, tiktok). Se un profilo mostra disconnected=true, il token OAuth è scaduto o è stato revocato e la connessione deve essere ristabilita tramite la dashboard web. Restituisce 401 se la chiave API è mancante o non valida. Restituisce 502 se il servizio upstream dei profili è temporaneamente non disponibile.

📄️Get social profile detail

Restituisce i dettagli completi di una specifica piattaforma social collegata, incluse tutte le pagine o i sotto-account collegati (es. le Pagine Facebook gestite dal profilo Facebook connesso). Il parametro di percorso platform è case-insensitive e deve essere uno tra: facebook, instagram, linkedin, google, tiktok. La risposta include le informazioni di primo livello del profilo (username, nome del profilo, immagine, sito web, biografia, numero di link, data di connessione, stato disconnected) e un array pages. Ogni voce di pagina contiene l'ID della pagina, il nome della pagina, l'immagine del profilo, lo username, il sito web, la biografia, il numero di link, le date di connessione e di scadenza e un flag disconnected. Usa questo endpoint quando devi elencare tutte le pagine o i sotto-account disponibili in una connessione a una piattaforma, ad esempio per selezionare su quale Pagina Facebook pubblicare i contenuti. Restituisce 404 se non esiste alcun profilo collegato per il nome di piattaforma indicato. Potrebbe significare che la piattaforma non è mai stata collegata o che è stata rimossa. Restituisce 401 se la chiave API è mancante o non valida. Restituisce 502 se il servizio upstream dei profili è temporaneamente non disponibile.