Copier des commentaires Facebook dans un tableur fonctionne pour dix commentaires. Cela échoue lorsqu’une publication en compte des centaines, que des auteurs sont absents, que le texte contient des emoji ou des sauts de ligne, et que vous devez répéter l’export demain.
Ce tutoriel utilise la SocQ Facebook Comments API pour collecter les commentaires à partir d’URL de publications publiques, conserver un JSON normalisé et générer un CSV sûr pour Excel, Google Sheets, l’analyse, la modération ou une archive auditable.
Réponse rapide : envoyez des URL de publications publiques à
POST /v1/facebook/comments, conservez l’ID de tâche renvoyé, interrogez jusqu’à la fin de la tâche et stockez les enregistrements de commentaires normalisés en JSON. Créez le CSV comme un export dérivé, avec un commentaire par ligne, un encodage UTF-8, des ID de parent explicites et une protection contre l’injection de formules dans les tableurs.
Trois façons d’exporter des commentaires Facebook
Copier-coller manuel
C’est raisonnable pour quelques commentaires visibles et une tâche ponctuelle. Ce n’est pas reproductible, cela ne conserve pas d’ID stables et rend difficile l’audit des réponses, des auteurs, des horodatages et des pièces jointes.
Un outil d’export sans code
Les outils sans code sont pratiques lorsqu’une personne a besoin d’un fichier Excel immédiatement. Vérifiez quels types d’URL publiques sont pris en charge, si les réponses et les pièces jointes sont incluses, combien de commentaires peuvent être exportés et comment le fournisseur stocke les données.
Un workflow par API
Une API convient mieux aux exports récurrents, aux publications multiples, aux produits internes, aux rapports planifiés, à la validation et au chargement en base de données. Elle demande plus de mise en place, mais offre un état de tâche explicite, du JSON brut, un code de transformation stable et une sortie reproductible.
JSON ou CSV ?
Gardez le JSON comme source de référence. Il conserve les structures imbriquées :
- L’identité de l’
authoret les champs de profil. - Les
metrics, comme les mentions « J’aime » visibles et le nombre de réponses. - Les pièces jointes
media. - Les références
extraà la publication source et au commentaire parent. - La nullabilité et les champs futurs.
Le CSV est un format de présentation et d’échange. Il est utile pour Excel, Google Sheets, les imports BI, l’examen de jeux-concours, l’étiquetage et l’analyse simple, mais les valeurs imbriquées doivent être aplaties et les informations de type peuvent être perdues.
La conception la plus sûre est la suivante :
Public post URLs
↓
Facebook Comments API
↓
Immutable raw JSON
↓
Validated normalized records
↓
CSV / warehouse / dashboard
Envoyer des URL de publications Facebook publiques
curl -X POST "https://api.socq.ai/v1/facebook/comments" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"urls": [
"https://www.facebook.com/facebook/posts/POST_ID"
]
}'
L’endpoint actuel accepte une ou plusieurs URL de publications Facebook publiques prises en charge. Il n’accepte ni terme de recherche, ni nom de Page, ni URL de groupe privé à la place d’une publication publique.
Avant l’envoi :
- Exigez HTTPS et un nom d’hôte Facebook.
- Résolvez les URL dans une étape de prétraitement contrôlée si vous prenez en charge les liens de partage.
- Supprimez les paramètres de suivi lorsque cela ne change pas l’identité de la publication.
- Dédupliquez les URL canoniques.
- Conservez l’entrée d’origine pour la traçabilité.
Interroger la tâche asynchrone
La réponse de création contient un ID de tâche. Conservez-le avant d’interroger :
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=100" \
-H "Authorization: Bearer $SOCQ_API_KEY"
Considérez queued et running comme normaux. Espacez les requêtes avec un délai croissant. En cas de succès, traitez les enregistrements de data.results.items ; lorsque la réponse indique has_more, poursuivez avec son next_cursor.
Stockez l’URL d’entrée, l’ID de tâche, l’heure d’envoi, l’état terminal, le dernier curseur validé et la catégorie d’erreur. Si un worker redémarre, reprenez la tâche existante plutôt que d’en créer une en double.
Comprendre l’enregistrement de commentaire
Un enregistrement normalisé ressemble à ceci :
{
"id": "1569965031842178_123456789",
"platform": "facebook",
"resource": "comments",
"type": "comment",
"url": "https://www.facebook.com/facebook/posts/POST_ID",
"text": "Comment text",
"author": {
"id": "100064860875397",
"username": "facebook",
"name": "facebook",
"url": "https://www.facebook.com/facebook/"
},
"metrics": {
"likes_count": 18,
"replies_count": 2
},
"media": [],
"created_at": "2026-07-07T19:17:33",
"collected_at": "2026-07-08T08:59:45",
"extra": {
"post_id": "1569965031842178",
"parent_comment_id": null,
"input_url": "https://www.facebook.com/facebook/posts/POST_ID"
}
}
Des champs peuvent être indisponibles. Conservez un ID d’auteur manquant à null, pas à "unknown". Un nombre de mentions « J’aime » manquant n’est pas zéro. replies_count indique un nombre visible lorsqu’il est disponible ; il ne garantit pas à lui seul que le texte de chaque réponse figure dans le même jeu de résultats.
Enregistrer d’abord le JSON brut
Le stockage brut fournit une piste d’audit et permet de régénérer un CSV corrigé sans rappeler la source. Enregistrez :
- Le fournisseur et la version de l’endpoint.
- L’ID de tâche et les entrées d’origine.
- La page de réponse et le curseur.
- L’horodatage de collecte.
- Le corps de réponse brut ou le lot d’enregistrements.
- Le résultat de la validation et la version de la transformation.
Chiffrez le stockage sensible, appliquez une durée de conservation appropriée et restreignez l’accès. « Publiquement visible » ne signifie pas « exempt d’obligations en matière de vie privée ».
Exporter les commentaires en CSV avec Python
L’exemple ci-dessous aplatit les enregistrements et protège les cellules de tableur qui commencent par des caractères de formule :
import csv
import json
FORMULA_PREFIXES = ("=", "+", "-", "@")
def spreadsheet_safe(value):
if value is None:
return ""
text = str(value)
if text.startswith(FORMULA_PREFIXES):
return "'" + text
return text
def flatten(comment):
author = comment.get("author") or {}
metrics = comment.get("metrics") or {}
extra = comment.get("extra") or {}
return {
"post_id": extra.get("post_id"),
"comment_id": comment.get("id"),
"parent_comment_id": extra.get("parent_comment_id"),
"author_id": author.get("id"),
"author_name": spreadsheet_safe(author.get("name")),
"comment_text": spreadsheet_safe(comment.get("text")),
"likes_count": metrics.get("likes_count"),
"replies_count": metrics.get("replies_count"),
"created_at": comment.get("created_at"),
"collected_at": comment.get("collected_at"),
"source_url": extra.get("input_url") or comment.get("url"),
}
with open("facebook-comments.json", encoding="utf-8") as source:
comments = json.load(source)
rows = [flatten(comment) for comment in comments]
fields = list(rows[0].keys()) if rows else []
with open("facebook-comments.csv", "w", newline="", encoding="utf-8-sig") as output:
writer = csv.DictWriter(output, fieldnames=fields)
writer.writeheader()
writer.writerows(rows)
utf-8-sig écrit une marque d’ordre des octets (BOM) UTF-8 qui aide les installations courantes d’Excel à détecter l’Unicode. Le writer CSV de Python met correctement entre guillemets les virgules, les guillemets et les sauts de ligne intégrés.
Ne créez pas de CSV en joignant des valeurs par des virgules. Un commentaire peut légitimement contenir tous ces caractères.
Exporter avec Node.js
Utilisez une bibliothèque CSV maintenue plutôt qu’une jointure de chaînes maison. La transformation reste la même :
import { writeFile } from "node:fs/promises";
import { stringify } from "csv-stringify/sync";
const unsafe = /^[=+\-@]/;
const safe = (value) => {
if (value == null) return "";
const text = String(value);
return unsafe.test(text) ? `'${text}` : text;
};
const rows = comments.map((comment) => ({
post_id: comment.extra?.post_id ?? "",
comment_id: comment.id ?? "",
parent_comment_id: comment.extra?.parent_comment_id ?? "",
author_id: comment.author?.id ?? "",
author_name: safe(comment.author?.name),
comment_text: safe(comment.text),
likes_count: comment.metrics?.likes_count ?? "",
replies_count: comment.metrics?.replies_count ?? "",
created_at: comment.created_at ?? "",
collected_at: comment.collected_at ?? "",
source_url: comment.extra?.input_url ?? comment.url ?? "",
}));
const csv = stringify(rows, { header: true });
await writeFile("facebook-comments.csv", `\uFEFF${csv}`, "utf8");
Figez la version de la dépendance CSV, validez le nombre de lignes obtenu et testez des commentaires contenant des emoji, des virgules, des guillemets doubles, des tabulations, des sauts de ligne et des préfixes de formule.
Modéliser les commentaires et les réponses
Utilisez comment_id comme clé d’enregistrement privilégiée. parent_comment_id vaut null pour un commentaire de premier niveau et référence un parent lorsque cette relation est disponible.
N’utilisez pas le nom affiché comme clé d’identité. Les noms ne sont ni uniques ni permanents. De même, ne supposez pas que l’ordre d’affichage est chronologique : les plateformes peuvent classer les commentaires et personnaliser l’ordre visible.
Pour les exports récurrents, faites un upsert de l’entité commentaire et ajoutez un instantané de collecte pour les métriques modifiables :
comment
comment_id
post_id
parent_comment_id
author_id
text
created_at
first_seen_at
last_seen_at
comment_snapshot
comment_id
collected_at
likes_count
replies_count
Construire un export incrémental
Pour un workflow quotidien :
- Envoyez l’URL canonique de la publication.
- Interrogez et validez la tâche terminée.
- Faites un upsert par ID de commentaire.
- Marquez chaque enregistrement renvoyé avec
last_seen_at. - Ajoutez des instantanés de métriques uniquement pour les collectes réussies.
- Générez le CSV à partir de la base de données ou du JSON validé.
- Consignez les nombres d’éléments envoyés, renvoyés, valides, nouveaux, mis à jour et rejetés.
Ne marquez pas un commentaire déjà vu comme supprimé après une seule collecte en échec ou incomplète. Exigez plusieurs observations réussies ou une politique de vérification distincte.
Valider l’export
Vérifiez que :
- Chaque enregistrement indique
platform: facebooketresource: comments. - Les ID sont uniques au sein d’une publication lorsqu’ils sont présents.
- Les horodatages s’analysent de façon cohérente.
- Les compteurs sont non négatifs ou nuls.
- Les ID de parent ne pointent pas vers le même commentaire.
- Le nombre de lignes du CSV est égal au nombre d’enregistrements transformés.
- Un échantillon d’emoji, de texte multilingue, de guillemets et de sauts de ligne survit à un aller-retour.
- Chaque ligne conserve son URL source et son heure de collecte.
Comparez la sortie de l’API avec un petit échantillon public dans un navigateur, mais ne traitez pas le nombre visible dans le navigateur comme un oracle exact de complétude. Les commentaires peuvent être classés, filtrés, supprimés, masqués ou modifiés entre deux observations.
Usage responsable
Ne collectez que les commentaires publics nécessaires à un objectif légitime. Ne contournez pas la connexion, les groupes privés, les restrictions d’audience ni les contrôles techniques. Évitez d’utiliser des commentaires pour déduire des caractéristiques sensibles ou prendre des décisions à fort impact sur des personnes.
Définissez une base légale lorsque c’est requis, limitez la conservation, sécurisez les exports, contrôlez le partage des tableurs, respectez les droits de suppression et d’accès applicables, et examinez les conditions actuelles de Meta et la loi locale. Ce tutoriel ne constitue pas un conseil juridique.
Questions fréquentes (FAQ)
Peut-on exporter tous les commentaires d’une publication Facebook ?
Aucun fournisseur ne devrait promettre une complétude universelle. La disponibilité dépend de la publication publique, de l’ordre visible, du comportement de la source, des suppressions et de la couverture de l’endpoint.
L’export inclut-il les réponses ?
Le modèle normalisé peut représenter les relations de parenté et le nombre de réponses visibles. Vérifiez sur votre échantillon la couverture actuelle de l’endpoint pour le texte des réponses au lieu de supposer que chaque réponse est renvoyée.
Peut-on exporter les commentaires d’un groupe privé ?
Pas avec ce workflow de données publiques. Ne contournez pas la confidentialité ni les contrôles d’accès des groupes.
Faut-il choisir JSON ou CSV ?
Gardez le JSON comme source auditable et générez le CSV pour les tableurs et les imports simples.
Les emoji survivent-ils à l’export ?
Oui, lorsque toute la chaîne utilise UTF-8. Les exemples écrivent un CSV UTF-8 avec BOM pour la compatibilité avec Excel.
Pourquoi protéger les préfixes de formule ?
Un tableur peut interpréter un texte de commentaire commençant par =, +, - ou @ comme une formule. Préfixer ces cellules empêche un texte non fiable de s’exécuter comme contenu de tableur.
Peut-on automatiser l’export tous les jours ?
Oui. Conservez l’état des tâches, utilisez un délai croissant, dédupliquez par ID de commentaire, ajoutez des instantanés de métriques et ne générez le fichier qu’à partir de résultats validés.
FACEBOOK API
Tester le workflow avec une URL publique Facebook
Envoyez des entrées publiques et recevez des enregistrements normalisés, avec un contexte de source traçable.
Découvrir les API Facebook