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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | URL 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.
- Prepara uno o più URL pubblici di profili o pagine su facebook.com, www.facebook.com o m.facebook.com.
- Invia urls con POST a /v1/facebook/profiles.
- Interroga /v1/tasks/{task_id} finché lo stato è succeeded.
- 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.
API correlate
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.