FacebookComentariosCSVJSONTutorial de API

Cómo exportar comentarios de Facebook a JSON o CSV

Exporte los comentarios de publicaciones públicas de Facebook mediante una API, conserve el JSON normalizado y cree archivos CSV UTF-8 seguros para Excel, Sheets, análisis o archivo.

SocQActualizado el 19 de julio de 20268 min de lectura

Copiar los comentarios de Facebook a una hoja de cálculo funciona con diez comentarios. Falla cuando una publicación tiene cientos de comentarios, faltan autores, el texto contiene emojis o saltos de línea, y hay que repetir la exportación al día siguiente.

Este tutorial usa la SocQ Facebook Comments API para recopilar comentarios de URL de publicaciones públicas, conservar el JSON normalizado y generar un CSV seguro para Excel, Google Sheets, analítica, moderación o un archivo auditable.

Respuesta rápida: Envíe URL de publicaciones públicas a POST /v1/facebook/comments, guarde el ID de tarea devuelto, consulte hasta que termine y almacene los registros de comentarios normalizados como JSON. Cree el CSV como una exportación derivada, con un comentario por fila, codificación UTF-8, ID de comentario padre explícitos y protección contra la inyección de fórmulas en hojas de cálculo.

Tres formas de exportar comentarios de Facebook

Copiar y pegar manualmente

Es razonable para unos pocos comentarios visibles y una tarea puntual. No es reproducible, no conserva ID estables y dificulta la auditoría de respuestas, autores, marcas de tiempo y archivos adjuntos.

Un exportador sin código

Las herramientas sin código son cómodas cuando una persona necesita un archivo de Excel de inmediato. Verifique qué tipos de URL públicas admiten, si incluyen respuestas y archivos adjuntos, cuántos comentarios se pueden exportar y cómo almacena los datos el proveedor.

Un flujo de trabajo con API

Una API es la mejor opción para exportaciones recurrentes, varias publicaciones, productos internos, reportes programados, validación y carga en bases de datos. Requiere más configuración, pero ofrece un estado de tarea explícito, JSON sin procesar, código de transformación estable y una salida repetible.

¿JSON o CSV?

Conserve el JSON como fuente de verdad. Mantiene las estructuras anidadas:

  • La identidad de author y los campos del perfil.
  • metrics, como los Me gusta visibles y la cantidad de respuestas.
  • Los archivos adjuntos de media.
  • Las referencias de extra a la publicación de origen y al comentario padre.
  • Los valores nulos y los campos futuros.

El CSV es un formato de presentación e intercambio. Es útil para Excel, Google Sheets, importaciones a BI, revisión de sorteos, etiquetado y análisis sencillos, pero los valores anidados deben aplanarse y puede perderse la información de tipos.

El diseño más seguro es:

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

Envíe URL de publicaciones públicas de 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"
    ]
  }'

El endpoint actual acepta una o más URL de publicaciones públicas de Facebook compatibles. No acepta un término de búsqueda, el nombre de una página ni la URL de un grupo privado en lugar de una publicación pública.

Antes de enviar:

  1. Exija HTTPS y un nombre de host de Facebook.
  2. Resuelva las URL en un paso de preprocesamiento controlado si admite enlaces para compartir.
  3. Elimine los parámetros de seguimiento cuando eso no cambie la identidad de la publicación.
  4. Deduplique las URL canónicas.
  5. Conserve la entrada original como prueba de procedencia.

Consulte la tarea asíncrona

La respuesta de creación contiene un ID de tarea. Guárdelo antes de consultar:

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

Considere normales los estados queued y running. Espere un poco más entre solicitudes sucesivas. Cuando termine con éxito, procese los registros de data.results.items; si la respuesta indica has_more, continúe con su next_cursor.

Guarde la URL de entrada, el ID de tarea, la hora de envío, el estado terminal, el último cursor confirmado y la categoría del error. Si un worker se reinicia, reanude la tarea existente en lugar de crear una duplicada.

Cómo es el registro de un comentario

Un registro normalizado se parece a esto:

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

Algunos campos pueden no estar disponibles. Conserve como null el ID de un autor faltante, no como "unknown". Una cantidad de Me gusta faltante no es cero. replies_count informa una cantidad visible cuando está disponible; por sí solo no garantiza que el texto de cada respuesta esté presente en el mismo conjunto de resultados.

Guarde primero el JSON sin procesar

El almacenamiento sin procesar ofrece un registro de auditoría y permite regenerar un CSV corregido sin volver a consultar la fuente. Guarde:

  • El proveedor y la versión del endpoint.
  • El ID de tarea y las entradas originales.
  • La página de respuesta y el cursor.
  • La marca de tiempo de recopilación.
  • El cuerpo de la respuesta sin procesar o el lote de registros.
  • El resultado de la validación y la versión de la transformación.

Cifre el almacenamiento sensible, aplique un período de retención adecuado y restrinja el acceso. “Visible públicamente” no significa “libre de obligaciones de privacidad”.

Exporte los comentarios a CSV con Python

El ejemplo siguiente aplana los registros y protege las celdas de la hoja de cálculo que comienzan con caracteres de fórmula:

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 escribe una marca de orden de bytes UTF-8 que ayuda a las instalaciones habituales de Excel a detectar Unicode. El escritor CSV de Python entrecomilla correctamente las comas, las comillas y los saltos de línea incrustados.

No cree el CSV uniendo valores con comas. Un comentario puede contener legítimamente todos esos caracteres.

Exporte con Node.js

Use una biblioteca de CSV mantenida en lugar de unir cadenas a mano. La transformación es la misma:

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

Fije la versión de la dependencia de CSV, valide la cantidad de filas resultante y pruebe comentarios que contengan emojis, comas, comillas dobles, tabulaciones, saltos de línea y prefijos de fórmula.

Modele los comentarios y las respuestas

Use comment_id como clave preferida del registro. parent_comment_id es null en un comentario de primer nivel y hace referencia a un comentario padre cuando esa relación está disponible.

No use el nombre visible como clave de identidad. Los nombres no son únicos ni permanentes. Del mismo modo, no suponga que el orden de visualización es cronológico: las plataformas pueden clasificar los comentarios y personalizar el orden visible.

Para exportaciones recurrentes, haga un upsert de la entidad del comentario y agregue una instantánea de cada recopilación para las métricas que cambian:

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

Cree una exportación incremental

Para un flujo de trabajo diario:

  1. Envíe la URL canónica de la publicación.
  2. Consulte y valide la tarea completada.
  3. Haga un upsert por ID de comentario.
  4. Marque cada registro devuelto con last_seen_at.
  5. Agregue instantáneas de métricas solo para las recopilaciones exitosas.
  6. Genere el CSV a partir de la base de datos o del JSON validado.
  7. Registre los conteos de elementos enviados, devueltos, válidos, nuevos, actualizados y rechazados.

No marque un comentario visto anteriormente como eliminado después de una recopilación fallida o incompleta. Exija varias observaciones exitosas o una política de verificación independiente.

Valide la exportación

Verifique que:

  • Cada registro indique platform: facebook y resource: comments.
  • Los ID sean únicos dentro de una publicación cuando existan.
  • Las marcas de tiempo se interpreten de forma consistente.
  • Los conteos sean no negativos o null.
  • Los ID de comentario padre no apunten al mismo comentario.
  • La cantidad de filas del CSV sea igual a la de registros transformados.
  • Una muestra de emojis, texto multilingüe, comillas y saltos de línea se conserve correctamente en la ida y vuelta.
  • Cada fila conserve su URL de origen y la hora de recopilación.

Compare la salida de la API con una pequeña muestra pública del navegador, pero no trate el conteo visible en el navegador como un indicador exacto de integridad. Los comentarios pueden clasificarse, filtrarse, eliminarse, ocultarse o cambiar entre observaciones.

Uso responsable

Recopile solo los comentarios públicos necesarios para un fin legítimo. No eluda el inicio de sesión, los grupos privados, las restricciones de audiencia ni los controles técnicos. Evite usar los comentarios para inferir características sensibles o tomar decisiones de alto impacto sobre las personas.

Defina una base legal cuando corresponda, limite la retención, proteja las exportaciones, controle cómo se comparten las hojas de cálculo, respete los derechos de eliminación y acceso aplicables, y revise los términos vigentes de Meta y la legislación local. Este tutorial no constituye asesoría legal.

Preguntas frecuentes (FAQ)

¿Se pueden exportar todos los comentarios de una publicación de Facebook?

Ningún proveedor debería prometer una integridad universal. La disponibilidad depende de la publicación pública, del orden visible, del comportamiento de la fuente, de las eliminaciones y de la cobertura del endpoint.

¿La exportación incluye las respuestas?

El modelo normalizado puede representar las relaciones con el comentario padre y las cantidades visibles de respuestas. Verifique con su muestra la cobertura actual del endpoint respecto del texto de las respuestas, en lugar de suponer que se devuelve cada respuesta.

¿Se pueden exportar comentarios de un grupo privado?

No con este flujo de trabajo de datos públicos. No eluda la privacidad ni los controles de acceso del grupo.

¿Debo elegir JSON o CSV?

Conserve el JSON como fuente auditable y genere el CSV para hojas de cálculo e importaciones sencillas.

¿Los emojis se conservarán en la exportación?

Sí, cuando todo el pipeline usa UTF-8. Los ejemplos escriben un CSV UTF-8 con BOM para que sea compatible con Excel.

¿Por qué proteger los prefijos de fórmula?

El software de hojas de cálculo puede interpretar como fórmula un texto de comentario que comienza con =, +, - o @. Anteponer un prefijo a esas celdas evita que un texto no confiable se ejecute como contenido de la hoja de cálculo.

¿Se puede automatizar la exportación todos los días?

Sí. Guarde el estado de las tareas, use espera progresiva, deduplique por ID de comentario, agregue instantáneas de métricas y genere el archivo solo a partir de resultados validados.

FACEBOOK API

Probar el flujo de trabajo con una URL pública de Facebook

Envíe entradas públicas y reciba registros normalizados con contexto de origen rastreable.

Ver las API de Facebook