Facebook Posts
Les publications Facebook sont des messages publics émis par des Pages, des profils ou des groupes, avec texte, liens, médias, contexte de l’auteur, horodatages et engagement visible. Ces signaux de contenu et d’engagement servent au suivi de campagnes, à la recherche éditoriale, à l’analyse d’audience et au reporting.
Fonctionnalités de la Facebook Posts API
- URL publiques prises en chargeCollecte les publications à partir d’URL publiques de Pages, de profils, de groupes ou de publications Facebook, dans une seule forme de réponse normalisée.
- Champs de contenu et de médiasRenvoie dans des champs normalisés le texte et l’ID de la publication, le contexte de l’auteur, les horodatages, les liens, les médias, les partages, les nombres de commentaires et les nombres de réactions visibles.
- Détail des réactionsFournit la ventilation visible des réactions like, love, wow, care, sad, angry et haha.
- Plafond de résultats demandéAccepte une ou plusieurs URL prises en charge et plafonne le nombre d’enregistrements de publications demandés avec results_limit.
- Limite des données publiquesLes contenus privés, restreints, réservés aux utilisateurs connectés ou supprimés restent hors du périmètre de la réponse.
Paramètres de la Facebook Posts API
| Paramètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | URL publiques de Pages, de profils, de groupes ou de publications Facebook, séparées par des virgules ou des retours à la ligne. |
results_limit | Facultatif | Nombre maximal d’enregistrements que la tâche de collecte doit demander. Doit être un entier positif. |
Comment utiliser la Facebook Posts API
Envoyez une tâche de collecte asynchrone, interrogez son ID de tâche, puis lisez les publications publiques normalisées grâce à la pagination par curseur.
- Préparez une ou plusieurs URL publiques de Pages, de profils, de groupes ou de publications Facebook.
- Envoyez urls, avec results_limit en option, en POST à /v1/facebook/posts.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded ou failed.
- Lisez /v1/tasks/{task_id}?limit=50 et suivez results.next_cursor tant qu’il reste des enregistrements.
curl -X POST "https://api.socq.ai/v1/facebook/posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.facebook.com/cern"],"results_limit":25}'
# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.Cas d’usage de la Facebook Posts API
- Suivi de Pages publiques : Collectez les publications publiques, horodatages, liens, références de médias et compteurs visibles des Pages Facebook que suit votre produit.
- Reporting de campagnes et de marque : Normalisez texte, réactions, commentaires, partages et médias avant d’envoyer les données de campagne vers des tableaux de bord ou des outils de BI.
- Recherche de contenus : Analysez les légendes publiques, les sujets, les liens, les images, les vidéos et les schémas d’engagement autour d’une marque, d’un événement ou d’un thème.
- Workflows d’écoute sociale : Acheminez les signaux des publications publiques vers des files de revue, des systèmes d’alerte ou des outils de recherche internes, sans maintenir de parseurs de pages fragiles.
- Archives de publications et pistes d’audit : Stockez les ID de publications normalisés, les URL sources, les horodatages, les compteurs visibles et les heures de collecte pour des archives et des rapports reproductibles.
Conseils d’expert pour la Facebook Posts API
- Commencez par de petits lots de Pages publiques, puis augmentez la limite seulement une fois que votre gestion des nouvelles tentatives et du recul progressif fonctionne.
- Stockez les ID de publications normalisés, les URL, les ID de tâche et next_cursor pour pouvoir reprendre la collecte après un échec.
- Attendez-vous à ce que certaines publications publiques omettent commentaires, médias, détail des réactions ou horodatages, selon la disponibilité à la source.
- Utilisez Comments API lorsque vous avez besoin de fils de commentaires publics plus complets que les champs d’aperçu allégés.
- Ne fondez pas votre intégration sur des données privées, restreintes, réservées aux utilisateurs connectés ou liées à un compte, sauf si la documentation publiée de l’API les prend explicitement en charge.
API associées
En complément de la Facebook Posts API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Facebook.
- Facebook Pages API — Récupérez les profils de Pages publiques, leurs coordonnées, leurs images et les notes d’audience visibles.
- 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.