Facebook Reels
Les Reels Facebook sont des vidéos courtes et publiques présentes dans le fil d’un profil ou d’une Page, avec légendes, contexte de l’auteur, métadonnées de lecture, horodatages et engagement visible. Ces enregistrements servent à inventorier des contenus, à étudier la vidéo courte, à surveiller des fils et à mener des analyses comparatives.
Fonctionnalités de la Facebook Reels API
- Fils de Reels de plusieurs profilsCollecte les Reels publics d’une ou plusieurs URL de profils ou de Pages Facebook, applique la limite demandée à chaque entrée et garde extra.input_url pour l’attribution.
- Médias vidéo normalisésRenvoie les URL de vidéos, les miniatures, les dimensions et la durée, avec les ID de Reels et les liens sources publics.
- Contexte du créateur et de l’engagementConserve pour chaque Reel normalisé la légende, le contexte public brut de l’auteur, les mentions « J’aime », commentaires, vues, lectures et partages visibles, ainsi que la date de publication.
- Parcours stable du filSuit les curseurs propres à chaque profil et supprime les Reels en double par ID, ID de publication ou URL avant d’atteindre la limite par entrée.
Paramètres de la Facebook Reels API
| Paramètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | URL de profils ou de Pages Facebook publics, séparées par des virgules ou des retours à la ligne. |
results_limit | Facultatif | Nombre maximal de Reels à collecter par URL d’entrée, de 20 à 2 000 ; la valeur par défaut est 100. |
Comment utiliser la Facebook Reels API
Envoyez des URL de profils ou de Pages publics sous forme de tâche asynchrone, interrogez son ID de tâche, puis lisez les Reels normalisés grâce à la pagination par curseur des résultats.
- Préparez une ou plusieurs URL de profils ou de Pages Facebook publics qui exposent des fils de Reels.
- Envoyez urls, avec results_limit en option, en POST à /v1/facebook/reels.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
- Lisez /v1/tasks/{task_id}?limit=50 et transmettez results.next_cursor tant qu’il reste des Reels enregistrés.
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.Cas d’usage de la Facebook Reels API
- Inventaire des Reels d’un profil : Rangez ID de Reels, liens sources, légendes, références vidéo, horodatages et extra.input_url dans un index de contenus propre à chaque profil.
- Étude du format vidéo court : Comparez durée, dimensions, miniatures, légendes et engagement visible pour comprendre comment les Reels publics sont conçus et accueillis.
- Surveillance d’un fil de Reels : Répétez les collectes sur des URL de profils ou de Pages choisis et croisez l’identité stable du Reel avec sa date de publication pour repérer les nouveaux enregistrements exposés.
Conseils d’expert pour la Facebook Reels API
- Utilisez des URL de profils et de Pages en facebook.com, www.facebook.com ou m.facebook.com qui exposent un fil de Reels public ; la seule validation de l’hôte ne garantit pas que la ressource visée convienne.
- Fixez results_limit en pensant au nombre d’URL d’entrée, car la limite de 20 à 2 000 s’applique indépendamment à chaque URL.
- En combinant des collectes répétées, dédoublonnez par ID de Reel, ID de publication ou URL avec extra.input_url, afin de conserver le bon profil source.
- Considérez les légendes, les champs d’auteur, les métriques, les horodatages et les métadonnées de média comme facultatifs, et vérifiez que le média contient une URL de vidéo avant de la lire ou de la télécharger.
- Si vous avez besoin du texte parlé, envoyez l’URL du Reel connu à Facebook Video Transcript API au lieu d’attendre une transcription dans les enregistrements de Reels.
API associées
En complément de la Facebook Reels API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Facebook.
- Facebook Posts API — Collectez les publications publiques, médias, réactions, commentaires et partages à partir d’URL Facebook prises en charge.
- Facebook Comments API — Collectez les commentaires publics, leurs auteurs, l’engagement, les médias et les liens sources à partir d’URL de publications.
- Facebook Video Transcript API — Extrayez le texte et le format des transcriptions disponibles à partir d’URL connues de publications vidéo ou de Reels publics.
- Facebook Group Posts API — Collectez les publications publiques à partir d’URL de groupes Facebook avec tri au choix, limites par groupe, contexte de l’auteur, médias vidéo et engagement visible.
- Facebook Ad Transcript API — Extrayez le texte parlé disponible, la langue, le format et le contexte source à partir d’URL de la Facebook Ad Library.
- Facebook Profiles API — Consultez des profils ou Pages publics à partir d’URL Facebook connues avec identité, bio, avatar, compteurs visibles et contexte de la saisie.