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.

facebook/pages
Profils2,4 crédits par résultat

facebook/posts
Publications1 crédit par résultat

facebook/group-posts
Publications1,2 crédit par résultat

facebook/reels
Publications0,7 crédit par résultat

facebook/comments
Commentaires0,3 crédit par résultat

facebook/comment-replies
Commentaires0,3 crédit par résultat

facebook/company-reviews
Commentaires0,5 crédit par résultat

facebook/video-transcript
Publications0,7 crédit par résultat

facebook/ad-transcript
Publications0,5 crédit par résultat

facebook/events-search
Recherche0,6 crédit par résultat

facebook/event-details
Recherche0,5 crédit par résultat

facebook/profile-events
Profils0,6 crédit par résultat

facebook/profile-photos
Publications0,5 crédit par résultat

facebook/profiles
Profils1,2 crédit par résultat
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é | SocQ | Facebook Graph API |
|---|---|---|
| Usage principal | Collecte de données publiques de Pages, publications, publications de groupes, commentaires, événements et transcriptions | Gérer des Pages, applications et ressources autorisées |
| OAuth côté client | Clé API SocQ ; pas d’OAuth Facebook côté client | Revue d’application Meta, autorisations et jetons d’accès |
| Créer ou modifier des publications | Non pris en charge | Pris en charge avec les autorisations de Page éligibles |
| Données privées ou restreintes | Non pris en charge | Uniquement les données accordées par des autorisations validées |
| Format de réponse | Enregistrements SocQ normalisés | Objets 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. 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. 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. 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.
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=50Cas 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.
Combinez les données de plusieurs plateformes pour des analyses métier plus complètes
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.