facebook/
group-posts

Collectez les publications de groupes Facebook publics à partir d’URL de groupes, avec un ordre au choix, et obtenez texte, auteurs, horodatages, vidéos et engagement visible sous forme d’enregistrements normalisés.

Facebook Group Posts API

Publications de groupes publics
Quatre modes de tri
Limite de résultats par groupe
1,2 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 Group Posts

Les publications de groupes Facebook sont des messages publics postés dans un groupe, avec leur texte, l’identité de l’auteur, la date de publication, les liens sources, les réactions, commentaires et vues visibles, ainsi que les médias vidéo. Ces enregistrements servent à surveiller l’activité d’un groupe, à étudier les discussions, à comparer l’engagement et à établir des rapports sur les contenus publics.

Fonctionnalités de la Facebook Group Posts API

  • Lots d’URL de groupes publicsAccepte une ou plusieurs URL de groupes Facebook publics et conserve l’URL du groupe d’origine dans chaque enregistrement de publication normalisé.
  • Quatre modes de tri des groupesChoisissez top_posts, recent_activity, chronological ou chronological_listings pour fixer l’ordre appliqué à l’ensemble des groupes envoyés.
  • Profondeur de collecte par grouperesults_limit s’applique séparément à chaque URL de groupe, avec 100 par défaut et une plage acceptée de 3 à 2 000.
  • Contexte de la publication et de l’auteurRenvoie les ID de publications, les URL sources, le texte du message, les ID et noms d’auteurs, les dates de publication et de collecte dans une structure homogène.
  • Engagement visible et vidéoInclut les nombres visibles de réactions, de commentaires et de vues de vidéo, ainsi que les URL normalisées de la vidéo et de sa vignette lorsqu’une publication publique les expose.

Paramètres de la Facebook Group Posts API

ParamètresObligatoireDescription
urlsObligatoireURL obligatoires de groupes Facebook publics, séparées par des virgules ou des retours à la ligne.
results_limitFacultatifNombre maximal de publications demandées pour chaque URL de groupe ; vaut 100 par défaut et accepte les entiers de 3 à 2 000.
sort_byFacultatifTri facultatif appliqué à chaque groupe envoyé : top_posts, recent_activity, chronological ou chronological_listings.

Comment utiliser la Facebook Group Posts API

Envoyez des URL de groupes publics, avec un tri facultatif et une limite de résultats par groupe, puis lisez les résultats de la tâche asynchrone grâce à la pagination par curseur.

  1. Préparez une ou plusieurs URL de groupes Facebook publics.
  2. Envoyez urls, avec results_limit et sort_by en option, en POST à /v1/facebook/group-posts, puis conservez le task_id renvoyé.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou renvoie un échec.
  4. Lisez data.results.items et demandez le next_cursor renvoyé tant que has_more reste à true.
curl -X POST "https://api.socq.ai/v1/facebook/group-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.facebook.com/groups/1270525996445602/"],"results_limit":30,"sort_by":"recent_activity"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Cas d’usage de la Facebook Group Posts API

  • Revue de l’activité de groupes publics : Avec le tri recent_activity ou chronological et les champs message, author, created_at et group_url, parcourez les publications publiques de groupes sélectionnés.
  • Archives de discussions de groupes : Stockez les ID de publications, le texte des messages, le contexte des auteurs, les URL sources et les dates de publication et de collecte comme enregistrements de groupe publics attribuables.
  • Comparaison d’engagement à tri égal : Appliquez le même sort_by à toutes les URL de groupes et comparez reactions_count, comments_count et views_count sous un seul ordre.

Conseils d’expert pour la Facebook Group Posts API

  • Envoyez les URL publiques directes des groupes plutôt que leur nom, pour que chaque entrée reste liée à une source sans ambiguïté.
  • Calculez la profondeur demandée en multipliant le nombre d’éléments de urls par results_limit, car la limite s’applique séparément à chaque groupe.
  • Lancez des tâches distinctes pour comparer des modes de tri, car une seule valeur de sort_by est appliquée à toutes les URL de groupes d’une requête.
  • Conservez id et extra.group_url ensemble pour que les enregistrements en aval restent attribuables et puissent être dédoublonnés au sein de chaque groupe.
  • Considérez l’auteur, le message, la date de publication, les médias vidéo et les nombres de vues de vidéo comme facultatifs lorsqu’une publication publique ne les expose pas.
  • Suivez results.next_cursor jusqu’à ce que has_more passe à false lorsque la tâche terminée compte plus d’une page de résultats.

En complément de la Facebook Group 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 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 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 Profile Photos API — Collectez les photos publiques à partir d’URL de profils ou de Pages avec légendes, contexte de l’auteur, engagement, métadonnées d’image et références sources.

Explorer d’autres plateformes

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

Facebook Group Posts API — FAQ

Facebook Group Posts API est une interface programmatique qui récupère les publications publiques d’une ou plusieurs URL de groupes Facebook, avec un tri facultatif. Elle renvoie le texte normalisé des publications, les détails des auteurs, les horodatages, les médias vidéo, l’engagement visible et l’URL du groupe source.

Envoyez une ou plusieurs URL de groupes Facebook publics dans urls. Les listes d’entrée vides sont rejetées, et un contenu que la surface publique du groupe n’expose pas ne peut pas apparaître dans les résultats.

sort_by accepte top_posts, recent_activity, chronological ou chronological_listings. La valeur choisie s’applique à toutes les URL de groupes de la requête.

results_limit vaut 100 par défaut, accepte les entiers de 3 à 2 000 et s’applique séparément à chaque URL de groupe. Deux URL avec results_limit à 30 demandent jusqu’à 60 publications.

Un enregistrement normalisé peut contenir id, url, message, author, reactions_count, comments_count, views_count, les médias vidéo, created_at, collected_at et extra.group_url. Les champs absents de la publication publique restent null, à zéro ou vides selon leur type normalisé.

Lisez data.results.items depuis GET /v1/tasks/{task_id}. Lorsque has_more vaut true, transmettez results.next_cursor comme cursor à la requête de tâche suivante ; chaque page accepte un limit de 1 à 500.

Chaque publication de groupe renvoyée coûte 1,2 crédit SocQ. L’estimation de la requête se base sur le nombre d’éléments de urls multiplié par results_limit, et un jeu de résultats vide n’entraîne aucun frais de résultat.