facebook/
reels

Collectez les Reels Facebook publics à partir d’URL de profils ou de Pages et obtenez légendes, contexte de l’auteur, engagement, métadonnées vidéo et liens sources sous forme d’enregistrements normalisés.

Facebook Reels API

Reels de profils
Métadonnées vidéo
Données publiques
0,7 crédit par résultat
Prêt
Prêt

Saisissez des paramètres et envoyez une requête. L’état de la tâche et les résultats normalisés s’afficheront ici.

README

Par SocQ · Mis à jour le

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ètresObligatoireDescription
urlsObligatoireURL de profils ou de Pages Facebook publics, séparées par des virgules ou des retours à la ligne.
results_limitFacultatifNombre 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.

  1. Préparez une ou plusieurs URL de profils ou de Pages Facebook publics qui exposent des fils de Reels.
  2. Envoyez urls, avec results_limit en option, en POST à /v1/facebook/reels.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
  4. 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.

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.

Explorer d’autres plateformes

Combinez les données Facebook avec les données publiques d’autres plateformes sociales prises en charge.

Facebook Reels API — FAQ

Facebook Reels API est une interface programmatique qui collecte des enregistrements de vidéos courtes depuis le fil de Reels public d’un profil ou d’une Page Facebook donnés, ce qui simplifie l’inventaire en masse et l’observation dans la durée. Les équipes de contenu s’en servent pour le suivi de comptes et la recherche comparative, mais seuls les Reels accessibles par le fil public de la cible sont couverts.

Utilisez des profils ou des Pages publics sur facebook.com, www.facebook.com ou m.facebook.com. La validation ne contrôle que l’hôte : une autre ressource Facebook peut donc ne renvoyer aucun fil de Reels approprié.

Un enregistrement peut contenir l’ID du Reel, l’URL canonique, le texte de la légende, le contexte public brut de l’auteur, les métriques visibles, l’URL de la vidéo, la miniature, les dimensions, la durée, created_at, collected_at et extra.input_url.

Non. Les enregistrements de Reels contiennent les légendes et les métadonnées vidéo, tandis que le texte parlé disponible est pris en charge par Facebook Video Transcript API, dédiée aux URL de Reels compatibles.

Non. Cet endpoint lit les fils de Reels d’URL de profils ou de Pages publics connus ; il n’offre ni recherche par mot-clé, ni découverte des tendances, ni découverte à partir de l’audio.

Réglez results_limit de 20 à 2 000 ; la valeur par défaut est 100. La limite s’applique séparément à chaque URL envoyée.

Non. La collecte s’arrête à la limite par URL, à la fin du fil disponible ou après 100 pages de fil, et les Reels privés, restreints, supprimés, réservés aux utilisateurs connectés ou indisponibles peuvent être absents.

Chaque Reel enregistré coûte 0,7 crédit, sans frais de base par tâche. Les estimations multiplient la limite de résultats par URL par le nombre d’URL envoyées.