facebook/
profile-photos

Raccogli le foto pubbliche di profili e pagine Facebook da uno o più URL, con didascalie, contesto dell’autore, engagement, metadati delle immagini e link di origine come record normalizzati.

Facebook Profile Photos API

Foto dei profili
Metadati delle immagini
Dati pubblici
0,5 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 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

ParametriObbligatorioDescrizione
urlsObbligatorioURL di profili o pagine Facebook pubblici, separati da virgole o a capo.
results_limitFacoltativoNumero 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.

  1. Prepara uno o più URL di profili o pagine Facebook pubblici.
  2. Invia con POST urls con un results_limit facoltativo a /v1/facebook/profile-photos.
  3. Interroga /v1/tasks/{task_id} finché lo stato è succeeded.
  4. 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.

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.

Esplora altre piattaforme

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

Facebook Profile Photos API — FAQ

Facebook Profile Photos API è un’interfaccia programmatica per organizzare il feed pubblico di foto di uno specifico profilo o di una pagina Facebook in record multimediali coerenti, semplificando l’inventario in blocco e il monitoraggio continuo. Questi record supportano la ricerca sui contenuti visivi e il monitoraggio dei profili, con una copertura limitata ai contenuti accessibili tramite il feed pubblico di foto del target.

Usa profili o pagine pubblici su facebook.com, www.facebook.com o m.facebook.com. La validazione controlla l’host, quindi un’altra risorsa di Facebook può comunque non restituire alcun feed di foto.

Un record può includere ID della foto, URL canonico, testo della didascalia, contesto pubblico grezzo dell’autore, metriche visibili, URL e dimensioni dei media, created_at, collected_at ed extra.input_url.

Imposta results_limit da 20 a 2.000; per impostazione predefinita viene usato 100. Il limite si applica separatamente a ogni URL inviato e un feed può terminare prima di raggiungerlo.

Le foto private, con restrizioni, eliminate, visibili solo dopo l’accesso o comunque non disponibili non vengono restituite. Struttura degli album, commenti, persone taggate, dettaglio completo delle reazioni e download dei file originali non sono garantiti.

Ogni record di foto salvato costa 0,5 crediti, senza alcun addebito base per l’attività. Le stime moltiplicano il limite di risultati per URL per il numero di URL inviati.