Facebook Profile Photos
Le foto dei profili Facebook sono immagini pubbliche collegate al feed di un profilo o di una pagina, con didascalie, contesto dell’autore, engagement visibile, dimensioni e link di origine. Questi record supportano inventari dei media, ricerche sui contenuti visivi e monitoraggio di singoli profili.
Funzionalità della Facebook Profile Photos API
- Feed di foto di più profiliRaccogli i record delle foto pubbliche da uno o più URL di profili o pagine Facebook, con il limite richiesto applicato separatamente a ogni input.
- Metadati normalizzati delle immaginiRestituisce URL delle immagini, miniature e metadati di larghezza, altezza e durata, insieme agli ID delle foto e ai link canonici.
- Contesto della foto e della fonteConserva didascalie, dati pubblici dell’autore, engagement visibile, timestamp ed extra.input_url per l’analisi e l’attribuzione della fonte.
- Scorrimento del feed a cursoreSegue i cursori del feed pubblico delle foto e rimuove i record duplicati per ID stabile, URL o identità dell’immagine prima di raggiungere il limite per input.
Parametri della Facebook Profile Photos API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | URL di profili o pagine Facebook pubblici, separati da virgole o a capo. |
results_limit | Facoltativo | Numero massimo di foto da raccogliere per ogni URL di input, da 20 a 2.000; il valore predefinito è 100. |
Come usare la Facebook Profile Photos API
Invia gli URL di profili o pagine pubblici come attività asincrona, interroga il relativo ID attività, poi leggi i record normalizzati delle foto con la paginazione a cursore dei risultati.
- Prepara uno o più URL di profili o pagine Facebook pubblici.
- Invia con POST urls con un results_limit facoltativo a /v1/facebook/profile-photos.
- Interroga /v1/tasks/{task_id} finché lo stato è succeeded.
- Leggi /v1/tasks/{task_id}?limit=50 e passa results.next_cursor quando esistono altre foto salvate.
curl -X POST "https://api.socq.ai/v1/facebook/profile-photos" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.facebook.com/NASA"],"results_limit":100}'
# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.Casi d’uso della Facebook Profile Photos API
- Inventario dei media pubblici: Organizza ID delle foto, link canonici, URL delle immagini, dimensioni, didascalie e input di origine in un indice degli asset specifico del profilo.
- Ricerca sui contenuti visivi: Confronta didascalie, metadati delle immagini, timestamp ed engagement visibile per studiare i modelli di pubblicazione delle foto pubbliche.
- Monitoraggio delle foto dei profili: Ripeti le raccolte per URL di profili o pagine selezionati e usa l’identità della foto insieme a extra.input_url per rilevare i record esposti di recente.
Consigli degli esperti per la Facebook Profile Photos API
- Usa URL di profili e pagine su facebook.com, www.facebook.com o m.facebook.com che espongono un feed pubblico di foto; la sola validazione dell’host non garantisce che la risorsa di destinazione sia adatta.
- Imposta results_limit tenendo conto del numero di URL di input, perché il limite da 20 a 2.000 si applica in modo indipendente a ogni URL.
- Quando unisci più raccolte, deduplica per id della foto, URL o identità dell’immagine insieme a extra.input_url, per mantenere il profilo di origine corretto.
- Considera facoltativi didascalie, campi dell’autore, metriche, timestamp e dimensioni dei media, e verifica che i media contengano un URL di immagine prima di visualizzarli o scaricarli.
API correlate
Oltre alla Facebook Profile Photos API, usa queste API quando ti serve un altro tipo di dati pubblici di Facebook.
- Facebook Posts API — Raccoglie post pubblici, media, reazioni, commenti e condivisioni da URL Facebook supportati.
- Facebook Video Transcript API — Estrae, quando disponibili, il testo e il formato della trascrizione dagli URL pubblici di video o Reels noti.
- Facebook Group Posts API — Raccoglie i post pubblici dagli URL dei gruppi Facebook con ordinamento selezionabile, limiti per gruppo, contesto dell’autore, video ed engagement visibile.
- Facebook Ad Transcript API — Estrae, quando disponibili, il testo parlato, la lingua, il formato e il contesto della fonte dagli URL della Facebook Ad Library.
- Facebook Profiles API — Consulta profili o Pagine pubblici da URL Facebook noti con identità, bio, avatar, contatori visibili e contesto dell’input.
- 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.