FacebookCommentiCSVJSONTutorial sulle API

Come esportare i commenti di Facebook in JSON o CSV

Esporta i commenti ai post pubblici di Facebook tramite API, conserva il JSON normalizzato e crea file CSV UTF-8 sicuri per Excel, Fogli Google, analisi o archivi.

SocQAggiornato il 19 luglio 20268 min di lettura

Copiare i commenti di Facebook in un foglio di calcolo funziona per dieci commenti. Non funziona più quando un post ha centinaia di commenti, mancano gli autori, il testo contiene emoji o a capo e devi ripetere l’esportazione il giorno dopo.

Questo tutorial usa la Facebook Comments API di SocQ per raccogliere i commenti dagli URL dei post pubblici, conservare il JSON normalizzato e generare un CSV sicuro per Excel, Fogli Google, analisi, moderazione o un archivio verificabile.

Risposta rapida: invia gli URL dei post pubblici a POST /v1/facebook/comments, salva l’ID attività restituito, interroga finché l’attività non è completata e conserva come JSON i record dei commenti normalizzati. Crea il CSV come esportazione derivata, con un commento per riga, codifica UTF-8, ID dei genitori espliciti e protezione dall’injection di formule nei fogli di calcolo.

Tre modi per esportare i commenti di Facebook

Copia e incolla manuale

È ragionevole per pochi commenti visibili e un’operazione una tantum. Non è riproducibile, non conserva ID stabili e rende difficile verificare risposte, autori, timestamp e allegati.

Un exporter no-code

Gli strumenti no-code sono comodi quando una persona ha bisogno subito di un file Excel. Controlla quali tipi di URL pubblici sono supportati, se risposte e allegati sono inclusi, quanti commenti si possono esportare e come il fornitore conserva i dati.

Un flusso di lavoro con API

Un’API è la scelta migliore per esportazioni ricorrenti, più post, prodotti interni, report programmati, validazione e caricamento in un database. Richiede più configurazione, ma offre uno stato esplicito delle attività, JSON grezzo, codice di trasformazione stabile e output ripetibile.

JSON o CSV?

Mantieni il JSON come fonte di verità. Conserva le strutture annidate:

  • Identità di author e campi del profilo.
  • metrics, come i Mi piace visibili e il numero di risposte.
  • Allegati media.
  • Riferimenti extra al post di origine e al commento genitore.
  • Nullabilità e campi futuri.

Il CSV è un formato di presentazione e di scambio. È utile per Excel, Fogli Google, importazioni in strumenti di BI, verifica di giveaway, etichettatura e analisi semplici, ma i valori annidati vanno appiattiti e le informazioni sui tipi possono andare perse.

L’impostazione più sicura è:

Public post URLs
      ↓
Facebook Comments API
      ↓
Immutable raw JSON
      ↓
Validated normalized records
      ↓
CSV / warehouse / dashboard

Invia gli URL dei post pubblici di Facebook

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 attuale accetta uno o più URL supportati di post pubblici di Facebook. Non accetta un termine di ricerca, il nome di una pagina né l’URL di un gruppo privato al posto di un post pubblico.

Prima dell’invio:

  1. Richiedi HTTPS e un hostname di Facebook.
  2. Risolvi gli URL in un passaggio di preelaborazione controllato se supporti i link di condivisione.
  3. Rimuovi i parametri di tracciamento quando questo non cambia l’identità del post.
  4. Deduplica gli URL canonici.
  5. Conserva l’input originale per la provenienza.

Interroga l’attività asincrona

La risposta di creazione contiene un ID attività. Salvalo prima di iniziare a interrogare:

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=100" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

Considera normali queued e running. Usa un backoff tra una richiesta e l’altra. Quando ha successo, elabora i record in data.results.items; se la risposta riporta has_more, continua con il suo next_cursor.

Salva URL di input, ID attività, momento dell’invio, stato terminale, ultimo cursore confermato e categoria dell’errore. Se un worker si riavvia, riprendi l’attività esistente invece di crearne una duplicata.

Capire il record di un commento

Un record normalizzato assomiglia a questo:

{
  "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"
  }
}

I campi possono non essere disponibili. Conserva un ID autore mancante come null, non come "unknown". Un numero di Mi piace mancante non è zero. replies_count riporta un conteggio visibile quando è disponibile; da solo non garantisce che il testo di ogni risposta sia presente nello stesso insieme di risultati.

Salva prima il JSON grezzo

L’archiviazione dei dati grezzi offre una traccia di audit e permette di rigenerare un CSV corretto senza interrogare di nuovo la fonte. Salva:

  • Fornitore e versione dell’endpoint.
  • ID attività e input originali.
  • Pagina della risposta e cursore.
  • Timestamp della raccolta.
  • Corpo grezzo della risposta o batch di record.
  • Esito della validazione e versione della trasformazione.

Cifra lo storage sensibile, applica un periodo di conservazione adeguato e limita l’accesso. “Visibile pubblicamente” non significa “privo di obblighi di privacy”.

Esportare i commenti in CSV con Python

L’esempio seguente appiattisce i record e protegge le celle del foglio di calcolo che iniziano con caratteri di formula:

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 scrive un byte-order mark UTF-8 che aiuta le installazioni più comuni di Excel a riconoscere l’Unicode. Il writer CSV di Python mette correttamente tra virgolette virgole, virgolette e a capo incorporati.

Non creare il CSV unendo i valori con le virgole. Un commento può legittimamente contenere tutti quei caratteri.

Esportare con Node.js

Usa una libreria CSV mantenuta invece di una concatenazione di stringhe personalizzata. La trasformazione resta la stessa:

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");

Blocca la versione della dipendenza CSV, convalida il numero di righe risultante e testa commenti che contengono emoji, virgole, virgolette doppie, tabulazioni, a capo e prefissi di formula.

Modellare commenti e risposte

Usa comment_id come chiave preferita del record. parent_comment_id è null per un commento di primo livello e fa riferimento a un genitore quando quella relazione è disponibile.

Non usare il nome visualizzato come chiave di identità. I nomi non sono né univoci né permanenti. Allo stesso modo, non dare per scontato che l’ordine di visualizzazione sia cronologico: le piattaforme possono classificare i commenti e personalizzare l’ordine visibile.

Per le esportazioni ricorrenti, fai l’upsert dell’entità commento e aggiungi un’istantanea di raccolta per le metriche modificabili:

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

Creare un’esportazione incrementale

Per un flusso di lavoro giornaliero:

  1. Invia l’URL canonico del post.
  2. Interroga e convalida l’attività completata.
  3. Fai l’upsert per ID del commento.
  4. Contrassegna ogni record restituito con last_seen_at.
  5. Aggiungi le istantanee delle metriche solo per le raccolte riuscite.
  6. Genera il CSV dal database o dal JSON convalidato.
  7. Registra i conteggi di elementi inviati, restituiti, validi, nuovi, aggiornati e rifiutati.

Non contrassegnare come eliminato un commento già visto dopo una sola raccolta fallita o incompleta. Richiedi più osservazioni riuscite o una policy di verifica separata.

Validare l’esportazione

Controlla che:

  • Ogni record riporti platform: facebook e resource: comments.
  • Gli ID siano univoci all’interno di un post, quando presenti.
  • I timestamp vengano interpretati in modo coerente.
  • I conteggi non siano negativi o siano null.
  • Gli ID dei genitori non puntino allo stesso commento.
  • Il numero di righe del CSV sia uguale al numero di record trasformati.
  • Un campione di emoji, testo multilingue, virgolette e a capo faccia correttamente il giro di andata e ritorno.
  • Ogni riga conservi il proprio URL di origine e il momento della raccolta.

Confronta l’output dell’API con un piccolo campione del browser pubblico, ma non considerare il conteggio visibile nel browser come un oracolo esatto di completezza. I commenti possono essere classificati, filtrati, eliminati, nascosti o modificati tra un’osservazione e l’altra.

Uso responsabile

Raccogli solo i commenti pubblici necessari per uno scopo legittimo. Non aggirare login, gruppi privati, restrizioni di pubblico o controlli tecnici. Evita di usare i commenti per dedurre caratteristiche sensibili o per prendere decisioni ad alto impatto sulle persone.

Definisci una base giuridica dove richiesto, limita la conservazione, proteggi le esportazioni, controlla la condivisione dei fogli di calcolo, rispetta i diritti applicabili di cancellazione e accesso e consulta i termini attuali di Meta e la legge locale. Questo tutorial non costituisce consulenza legale.

Domande frequenti (FAQ)

Posso esportare ogni commento di un post di Facebook?

Nessun fornitore dovrebbe promettere una completezza universale. La disponibilità dipende dal post pubblico, dall’ordine visibile, dal comportamento della fonte, dalle eliminazioni e dalla copertura dell’endpoint.

L’esportazione include le risposte?

Il modello normalizzato può rappresentare le relazioni con i genitori e il numero visibile di risposte. Verifica sul tuo campione la copertura attuale dell’endpoint per il testo delle risposte invece di dare per scontato che ogni risposta venga restituita.

Posso esportare i commenti di un gruppo privato?

Non con questo flusso di lavoro sui dati pubblici. Non aggirare la privacy dei gruppi né i controlli di accesso.

Devo scegliere JSON o CSV?

Mantieni il JSON come fonte verificabile e genera il CSV per i fogli di calcolo e le importazioni semplici.

Le emoji sopravvivono all’esportazione?

Sì, quando l’intera pipeline usa UTF-8. Gli esempi scrivono un CSV UTF-8 con BOM per la compatibilità con Excel.

Perché proteggere i prefissi di formula?

I software per fogli di calcolo possono interpretare come formula il testo di un commento che inizia con =, +, - o @. Aggiungere un prefisso a quelle celle impedisce che testo non attendibile venga eseguito come contenuto del foglio di calcolo.

Posso automatizzare l’esportazione ogni giorno?

Sì. Salva lo stato delle attività, usa il backoff, deduplica per ID del commento, aggiungi istantanee delle metriche e genera il file solo da risultati convalidati.

FACEBOOK API

Prova il flusso di lavoro con un URL pubblico di Facebook

Invia input pubblici e ricevi record normalizzati con un contesto di origine tracciabile.

Scopri le API di Facebook