facebook/
posts

Collectez les publications Facebook publiques à partir d’URL de Pages, de profils, de groupes ou de publications et obtenez texte normalisé, contexte de l’auteur, médias, réactions, nombres de commentaires et partages.

Facebook Posts API

Publications
Réactions
Données publiques
1 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 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ètresObligatoireDescription
urlsObligatoireURL publiques de Pages, de profils, de groupes ou de publications Facebook, séparées par des virgules ou des retours à la ligne.
results_limitFacultatifNombre 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.

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

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.

Explorer d’autres plateformes

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

Facebook Posts API — FAQ

Facebook Posts API collecte les publications accessibles publiquement à partir d’URL de Pages, de profils, de groupes ou de publications Facebook. Elle renvoie le texte normalisé, le contexte de l’auteur, les références de médias, les horodatages, les réactions, les nombres de commentaires et les partages.

Envoyez des URL publiques de Pages, de profils, de groupes ouverts ou de publications Facebook. Les groupes privés, les profils restreints, les publications supprimées et les surfaces réservées aux utilisateurs connectés peuvent ne renvoyer que des données limitées, voire aucun enregistrement.

Les champs de résultat courants sont id, url, message, author, metrics, reactions, media, created_at, collected_at et extra. Les métadonnées de tâche et de pagination des résultats sont renvoyées par les réponses d’API qui les entourent.

La collecte de publications publiques n’exige pas de cookies Facebook fournis par le client. Un contenu qui n’apparaît qu’après connexion sort du périmètre des données publiques.

Les images, les vidéos, le détail des réactions et les nombres de commentaires visibles sont renvoyés lorsque la publication publique les expose. Utilisez Facebook Comments API pour obtenir des commentaires individuels, et traitez les champs facultatifs de médias ou de réactions comme nullables.

Utilisez des tailles de page prudentes, un recul progressif après un code 429 ou une réponse de saturation similaire, et évitez les boucles de nouvelles tentatives trop serrées. Pour les gros traitements, collectez par petits lots et reprenez depuis les curseurs sauvegardés.

Vérifiez que la cible est accessible publiquement, que la publication n’a pas été supprimée ni restreinte et que les champs facultatifs demandés sont exposés publiquement. Facebook modifie souvent la structure de ses pages publiques : les clients doivent donc traiter l’absence de champs comme un cas normal de disponibilité.