facebook/
reels

Raccogli i Reel pubblici di Facebook da URL di profili o pagine, con didascalie, contesto dell’autore, engagement, metadati dei video e link di origine come record normalizzati.

Facebook Reels API

Reels dei profili
Metadati dei video
Dati pubblici
0,7 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 Reels

I Reel di Facebook sono video pubblici in formato breve nei feed di profili o pagine, con didascalie, contesto dell’autore, metadati di riproduzione, timestamp ed engagement visibile. Questi record supportano inventari dei contenuti, ricerche sui video brevi, monitoraggio dei feed e analisi comparative.

Funzionalità della Facebook Reels API

  • Feed di Reel di più profiliRaccogli i record dei Reel pubblici da uno o più URL di profili o pagine Facebook, applicando il limite richiesto a ogni input e conservando extra.input_url per l’attribuzione.
  • Media video normalizzatiRestituisce URL dei video, miniature, dimensioni e metadati di durata, insieme agli ID dei Reel e ai link di origine pubblici.
  • Contesto di creator ed engagementConserva didascalie, contesto pubblico grezzo dell’autore, Mi piace, commenti, visualizzazioni, riproduzioni, condivisioni e orari di pubblicazione visibili per ogni Reel normalizzato.
  • Scorrimento stabile del feedSegue i cursori specifici del profilo e rimuove i Reel duplicati per ID, ID del post o URL prima di raggiungere il limite per input.

Parametri della Facebook Reels API

ParametriObbligatorioDescrizione
urlsObbligatorioURL di profili o pagine Facebook pubblici, separati da virgole o a capo.
results_limitFacoltativoNumero massimo di Reel da raccogliere per ogni URL di input, da 20 a 2.000; il valore predefinito è 100.

Come usare la Facebook Reels API

Invia gli URL di profili o pagine pubblici come attività asincrona, interroga il relativo ID attività, poi leggi i record normalizzati dei Reel con la paginazione a cursore dei risultati.

  1. Prepara uno o più URL di profili o pagine Facebook pubblici che espongono feed di Reel.
  2. Invia con POST urls con un results_limit facoltativo a /v1/facebook/reels.
  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 altri Reel salvati.
curl -X POST "https://api.socq.ai/v1/facebook/reels" \
  -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 Reels API

  • Inventario dei Reel di un profilo: Organizza ID dei Reel, link di origine, didascalie, riferimenti ai video, timestamp ed extra.input_url in un indice dei contenuti specifico del profilo.
  • Ricerca sul formato dei video brevi: Confronta durata, dimensioni, miniature, didascalie ed engagement visibile per studiare come vengono confezionati e accolti i Reel pubblici.
  • Monitoraggio del feed dei Reel: Ripeti le raccolte per URL di profili o pagine selezionati e usa l’identità stabile del Reel insieme all’orario di pubblicazione per rilevare i record esposti di recente.

Consigli degli esperti per la Facebook Reels API

  • Usa URL di profili e pagine su facebook.com, www.facebook.com o m.facebook.com che espongono un feed pubblico di Reel; 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ù esecuzioni ripetute, deduplica per ID del Reel, ID del post o URL insieme a extra.input_url, per mantenere il profilo di origine corretto.
  • Considera facoltativi didascalie, campi dell’autore, metriche, timestamp e metadati dei media, e verifica che i media contengano un URL di video prima di visualizzarli o scaricarli.
  • Quando ti serve il testo del parlato, invia l’URL del Reel noto a Facebook Video Transcript API invece di aspettarti una trascrizione nei record dei Reel.

Oltre alla Facebook Reels 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 Comments API — Raccoglie commenti pubblici, autori, engagement, media e link alla fonte a partire dagli URL dei post.
  • 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.

Esplora altre piattaforme

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

Facebook Reels API — FAQ

Facebook Reels API è un’interfaccia programmatica per raccogliere record di video brevi dal feed pubblico di Reel di uno specifico profilo o di una pagina Facebook, semplificando l’inventario in blocco e l’osservazione continua. I team che si occupano di contenuti possono usare questi record per il monitoraggio degli account e la ricerca comparativa, ma sono coperti solo i Reel accessibili tramite il feed pubblico 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 Reel adatto.

Un record può includere ID del Reel, URL canonico, testo della didascalia, contesto pubblico grezzo dell’autore, metriche visibili, URL del video, miniatura, dimensioni, durata, created_at, collected_at ed extra.input_url.

No. I record dei Reel contengono didascalie e metadati dei video, mentre il testo del parlato disponibile è gestito dalla Facebook Video Transcript API dedicata per gli URL di Reel supportati.

No. Questo endpoint legge i feed di Reel per URL pubblici noti di profili o pagine; non offre ricerca per parola chiave, scoperta delle tendenze né scoperta basata sull’audio.

Imposta results_limit da 20 a 2.000; per impostazione predefinita viene usato 100. Il limite si applica separatamente a ogni URL inviato.

No. La raccolta si ferma al limite per URL, alla fine del feed disponibile o a 100 pagine di feed, e i Reel privati, con restrizioni, eliminati, visibili solo dopo l’accesso o comunque non disponibili possono mancare.

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