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ètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | URL obligatoires de groupes Facebook publics, séparées par des virgules ou des retours à la ligne. |
results_limit | Facultatif | Nombre maximal de publications demandées pour chaque URL de groupe ; vaut 100 par défaut et accepte les entiers de 3 à 2 000. |
sort_by | Facultatif | Tri 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.
- Préparez une ou plusieurs URL de groupes Facebook publics.
- Envoyez urls, avec results_limit et sort_by en option, en POST à /v1/facebook/group-posts, puis conservez le task_id renvoyé.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou renvoie un échec.
- 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 trueCas 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.
API associées
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.