Retour aux API
Données publiques Facebook

Facebook Public Data API

Collectez des profils de Pages Facebook publiques, des publications, des publications de groupes, des commentaires, des événements correspondant à un mot-clé et les transcriptions vidéo disponibles, avec des champs normalisés d’identité, de contenu, de source, de format, de lieu, de médias, de réactions, de participation et d’engagement.

API Facebook disponibles

Utilisez Pages pour les champs de profil publics, Posts pour le contenu général, Group Posts pour les enregistrements d’URL de groupes, Comments pour les discussions, Events Search pour les événements correspondant à un mot-clé, et Video Transcripts pour le texte parlé disponible à partir d’URL connues de publications vidéo ou de Reels. Les six partagent la même authentification et le même schéma de résultat de tâche.

Quelles données Facebook pouvez-vous récupérer ?

SocQ transforme les résultats publics Facebook pris en charge en enregistrements JSON cohérents pour l’enrichissement, la veille, l’étude et le reporting.

Profils de Pages publiques

Collectez les noms, catégories, descriptions, URL canoniques, photos de profil et photos de couverture des Pages lorsqu’ils sont publics.

Contact et audience

Renvoie les sites web publics, adresses e-mail, numéros de téléphone, lieux, nombres d’abonnés, mentions « J’aime » de la Page, notes et nombres d’avis lorsqu’ils sont exposés.

Contenu des publications publiques

Collectez le texte des publications, les auteurs, horodatages, liens, images, références vidéo et identifiants de publication normalisés.

Commentaires publics et engagement

Collectez le texte des commentaires publics, les champs d’auteur, horodatages, likes, nombres de réponses, partages et signaux de réaction lorsqu’ils sont disponibles.

Découverte d’événements publics

Recherchez par mot-clé les noms d’événements, calendriers, lieux, signaux de participation, images de couverture et statut en ligne ou passé.

Transcriptions vidéo disponibles

Extrayez le texte de transcription lié à sa source, au format texte brut ou WebVTT, à partir d’URL connues de publications vidéo ou de Reels publics.

SocQ vs Facebook Graph API

SocQ se concentre sur la collecte prise en charge de données publiques. La Graph API de Meta est le bon choix pour gérer les ressources qu’un utilisateur ou une entreprise a explicitement autorisées.

FonctionnalitéSocQFacebook Graph API
Usage principalCollecte de données publiques de Pages, publications, publications de groupes, commentaires, événements et transcriptionsGérer des Pages, applications et ressources autorisées
OAuth côté clientClé API SocQ ; pas d’OAuth Facebook côté clientRevue d’application Meta, autorisations et jetons d’accès
Créer ou modifier des publicationsNon pris en chargePris en charge avec les autorisations de Page éligibles
Données privées ou restreintesNon pris en chargeUniquement les données accordées par des autorisations validées
Format de réponseEnregistrements SocQ normalisésObjets natifs de la Graph API

Fonctionnement de l’API Facebook

La collecte s’exécute de façon asynchrone : votre application peut envoyer le travail, surveiller son état et traiter les pages de résultats indépendamment.

  1. 1. Envoyer une entrée

    Envoyez en POST des URL publiques de Pages, de publications, de groupes, de publications vidéo ou de Reels pris en charge, ou une requête par mot-clé pour la recherche d’événements, avec les champs documentés de l’endpoint choisi.

  2. 2. Interroger la tâche

    Utilisez l’ID de tâche renvoyé jusqu’à la réussite ou l’échec du traitement. Espacez vos requêtes après des réponses de saturation temporaire.

  3. 3. Lire et paginer

    Récupérez les éléments de résultat normalisés et suivez next_cursor lorsque la tâche contient d’autres enregistrements.

Démarrer avec une seule requête d’API

Authentifiez-vous avec une clé API SocQ. Cet exemple lance une tâche de Page Facebook publique ; utilisez /v1/facebook/posts pour les publications générales, /v1/facebook/group-posts pour les publications de groupes, /v1/facebook/comments pour les commentaires, /v1/facebook/events-search pour la découverte d’événements, ou /v1/facebook/video-transcript pour les URL connues de publications vidéo et de Reels.

curl -X POST "https://api.socq.ai/v1/facebook/pages" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.facebook.com/Meta"],"results_limit":10}'

# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50

Cas d’usage courants de l’API Facebook

Veille de marque

Suivez l’identité, les contacts, l’audience et les signaux de publications de Pages publiques pour vos propres marques ou celles de concurrents.

Étude des contenus et des réactions

Analysez les publications publiques, le texte des commentaires, les auteurs, horodatages, médias et l’engagement visible pour du reporting ou de la recherche éditoriale.

Enrichissement de Pages

Ajoutez des champs publics d’identité, de catégorie, de contact et d’audience Facebook à vos enregistrements CRM, annuaires ou comptes.

Découverte et suivi d’événements

Exploitez les champs d’identité, de calendrier, de lieu, de participation, de couverture et de statut d’événements trouvés par mot-clé pour organiser des enregistrements d’événements publics.

Pipelines de reporting

Envoyez des enregistrements normalisés de Pages et de publications publiques vers des tableaux de bord, des entrepôts de données et des outils de revue internes.

Indexation du contenu parlé

Indexez le texte de transcription disponible avec son URL source et son format pour des publications vidéo et des Reels publics choisis.

Limites et politique sur les données publiques

Les résultats publics Facebook sont dynamiques. Un champ visible pour une Page, une publication, un commentaire, un événement ou une transcription peut être absent d’un autre enregistrement ou changer avec le temps.

  • Les groupes privés, profils restreints, publications supprimées et contenus accessibles uniquement après connexion ne sont pas pris en charge.
  • Les enregistrements publics peuvent omettre les champs de contact, les auteurs de commentaires, les médias, les compteurs, les horodatages, les réponses ou le détail des réactions.
  • Une URL de vidéo publique envoyée ne produit aucun enregistrement de transcription lorsqu’aucun texte de transcription non vide n’est disponible.
  • Utilisez des lots plus petits, des fréquences de requêtes prudentes et un délai d’attente croissant entre les tentatives après des blocages temporaires ou une pression sur la limite de débit.
  • Ces endpoints ne créent, ne modifient, ne modèrent ni ne suppriment de contenu Facebook.

Questions fréquentes sur l’API Facebook

S’agit-il de la Graph API officielle de Facebook ?

Non. SocQ normalise les résultats publics Facebook pris en charge. Utilisez la Graph API de Meta pour la gestion de Pages autorisées, la publication et la modération.

Les utilisateurs doivent-ils connecter des comptes Facebook ?

Aucun OAuth Facebook côté client n’est requis pour les endpoints de données publiques pris en charge. Les requêtes s’authentifient avec une clé API SocQ.

SocQ peut-il collecter des groupes ou profils privés ?

Non. Les contenus Facebook privés, restreints ou accessibles uniquement après connexion sortent du périmètre pris en charge.

Comment l’utilisation est-elle facturée ?

Chaque carte d’endpoint affiche son prix actuel en crédits par résultat. Les tâches sont facturées d’après les enregistrements normalisés qu’elles renvoient.

Réunissez dans un même workflow les profils publics, les contenus et les données d’engagement de différentes plateformes pour suivre des marques, des créateurs et des sujets, et mener plus efficacement une veille et des analyses multiplateformes.

X API

Collectez des profils publics, les relations d’abonnés et d’abonnements, des posts, des réponses, des citations, les comptes qui ont reposté, des résultats de recherche et les tendances actuelles. Des résultats homogènes pour vos recherches et votre veille.

LinkedIn API

Récupérez des données LinkedIn publiques de profils, d’entreprises, de publications et d’offres d’emploi à partir d’URL connues, avec des champs normalisés d’identité, de carrière, d’entreprise, de contenu, d’engagement et d’offre.

Reddit API

Récupérez les publications et commentaires Reddit publics à partir d’URL connues, parcourez les publications récentes, les mieux notées ou tendance d’un subreddit, ou recherchez des discussions par mot-clé et par période de publication.

Pinterest API

Récupérez les données de profils Pinterest publics, résolvez des Pins connus, collectez les Pins de profils sélectionnés ou lancez une recherche par mot-clé pour étudier les créateurs, les contenus et les tendances visuelles.

Threads API

Récupérez des profils Threads publics, résolvez des publications connues ou collectez les publications de profils sélectionnés, avec des champs normalisés d’identité, de contenu, de médias, d’engagement et d’horodatage.

Bluesky API

Récupérez des profils Bluesky publics, résolvez des URL de publications connues ou collectez une page de publications d’un compte, avec identité, contenu, médias, horodatages et champs d’engagement visibles normalisés.