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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | URL di profili o pagine Facebook pubblici, separati da virgole o a capo. |
results_limit | Facoltativo | Numero 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.
- Prepara uno o più URL di profili o pagine Facebook pubblici che espongono feed di Reel.
- Invia con POST urls con un results_limit facoltativo a /v1/facebook/reels.
- Interroga /v1/tasks/{task_id} finché lo stato è succeeded.
- 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.
API correlate
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.