facebook/
profiles

Raccogli i dettagli pubblici di profili e pagine Facebook da URL noti, con identità, nomi, bio, avatar, contatori visibili e al massimo un record normalizzato per input.

Facebook Profiles API

Ricerca di profili
Ricerca di pagine
URL noti
1,2 crediti per risultato
Pronto
Pronto

Inserisci i parametri e invia una richiesta. Qui compariranno lo stato dell’attività e i risultati normalizzati.

README

A cura di SocQ · Aggiornato il

Facebook Profiles

I profili e le pagine Facebook sono superfici pubbliche di identità, con nomi, testo della bio o delle informazioni, avatar, link canonici e contatori visibili di pubblico o attività. Questi campi di identità e segnali pubblici supportano l’arricchimento degli URL, l’abbinamento delle entità, le istantanee dei metadati e le ricerche comparative.

Funzionalità della Facebook Profiles API

  • Ricerca diretta per URL notiInvia più URL pubblici di profili o pagine Facebook e ricevi al massimo un record di profilo normalizzato per ogni input.
  • Campi di identità normalizzatiRestituisce ID Facebook, URL canonico, nome visualizzato, tipo di record e URL di input originale in una struttura coerente.
  • Presentazione pubblica del profiloAcquisisce la bio pubblica, l’introduzione, la descrizione o il testo delle informazioni, insieme all’avatar disponibile del profilo o della pagina.
  • Contatori visibili del profiloNormalizza i comuni contatori pubblici di follower, seguiti, post, Mi piace, commenti, visualizzazioni, riproduzioni e condivisioni esposti dal target.

Parametri della Facebook Profiles API

ParametriObbligatorioDescrizione
urlsObbligatorioURL obbligatori di profili o pagine Facebook pubblici. Gli host accettati sono facebook.com, www.facebook.com e m.facebook.com; separa più valori con virgole o a capo.

Come usare la Facebook Profiles API

Invia gli URL di profili o pagine come attività asincrona, interroga il relativo ID attività, poi leggi i record normalizzati dei profili.

  1. Prepara uno o più URL pubblici di profili o pagine su facebook.com, www.facebook.com o m.facebook.com.
  2. Invia urls con POST a /v1/facebook/profiles.
  3. Interroga /v1/tasks/{task_id} finché lo stato è succeeded.
  4. Leggi data.results.items da /v1/tasks/{task_id}?limit=50 e segui results.next_cursor finché results.has_more è true.
curl -X POST "https://api.socq.ai/v1/facebook/profiles" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.facebook.com/NASA"]}'

# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.items.

Casi d’uso della Facebook Profiles API

  • Arricchimento di cataloghi di profili e pagine: Aggiungi ID normalizzati, nomi, link canonici, testo della bio, avatar e contatori visibili a un catalogo di URL Facebook noti.
  • Abbinamento dell’identità da URL noti: Usa ID, URL canonici, nomi ed extra.input_url restituiti per collegare i link inviati ai record di entità esistenti.
  • Istantanee dei metadati pubblici: Salva collected_at insieme al testo del profilo, all’avatar e ai contatori disponibili per confrontare i metadati pubblici tra più raccolte.

Consigli degli esperti per la Facebook Profiles API

  • Verifica che ogni URL punti al profilo o alla pagina desiderati, perché la validazione della richiesta controlla l’host Facebook ma non il percorso della risorsa.
  • Conserva extra.input_url quando riconcili un’attività con più URL, perché input duplicati o non disponibili possono produrre meno record degli URL inviati.
  • Considera nullable nomi, testo del profilo, avatar e singoli valori delle metriche, perché i profili personali e le pagine espongono campi pubblici diversi.
  • Usa l’endpoint Facebook dei contenuti corrispondente quando ti servono post, foto, Reels, eventi o recensioni invece dei metadati a livello di profilo.

Oltre alla Facebook Profiles API, usa queste API quando ti serve un altro tipo di dati pubblici di Facebook.

  • Facebook Pages API — Recupera i profili pubblici delle Pagine, i dati di contatto, le immagini e le valutazioni visibili del pubblico.
  • Facebook Posts API — Raccoglie post pubblici, media, reazioni, commenti e condivisioni da URL Facebook supportati.
  • Facebook Comments API — Raccoglie commenti pubblici, autori, engagement, media e link alla fonte a partire dagli URL dei post.
  • Facebook Profile Events API — Raccoglie gli eventi pubblici associati agli URL di profili o Pagine, con nomi, date, luoghi, media, metriche visibili e contesto della fonte.
  • Facebook Profile Photos API — Raccoglie le foto pubbliche dagli URL di profili o Pagine con didascalie, contesto dell’autore, engagement, metadati delle immagini e riferimenti alla fonte.
  • Facebook Reels API — Raccoglie i Reels pubblici dagli URL di profili o Pagine con didascalie, contesto dell’autore, metadati dei video, engagement visibile e riferimenti alla fonte.

Esplora altre piattaforme

Combina i dati di Facebook con i dati pubblici delle altre piattaforme social supportate.

Facebook Profiles API — FAQ

Facebook Profiles API è un’interfaccia programmatica per recuperare i dettagli pubblici di identità da URL noti di profili o pagine Facebook, rendendo i record più facili da arricchire e abbinare. Supporta l’arricchimento degli URL, l’abbinamento delle entità e le istantanee dei profili; ogni input produce al massimo un record pubblico e l’endpoint non effettua ricerche di profili per parola chiave.

Invia URL non vuoti su facebook.com, www.facebook.com o m.facebook.com. Il validatore controlla l’host ma non se il percorso identifica un profilo o una pagina, quindi questo endpoint effettua una ricerca diretta e non una ricerca di profili.

Un record normalizzato contiene id, platform, resource, type, url, name, text, avatar_url, metrics, created_at, collected_at ed extra.input_url. Al momento created_at viene restituito come null.

Sì, la ricerca è pensata per URL pubblici di profili o pagine. I loro campi visibili sono diversi, quindi i client non devono presumere che ogni record abbia la stessa bio, lo stesso avatar o gli stessi contatori.

Ogni URL può produrre al massimo un record, mentre i target duplicati, privati, con accesso limitato, eliminati, digitati in modo errato o non disponibili possono non produrne alcuno. Usa extra.input_url per abbinare i record restituiti alla richiesta originale.

L’utilizzo costa 1,2 crediti per ogni record di profilo salvato, senza alcun addebito base per l’attività. Un risultato vuoto non ha alcun addebito per risultato.