FacebookкомментарииCSVJSONруководство по API

Как экспортировать комментарии Facebook в JSON или CSV

Экспортируйте комментарии к публичным публикациям Facebook через API, сохраняйте нормализованный JSON и создавайте безопасные CSV-файлы в UTF-8 для Excel, Google Sheets, анализа или архива.

SocQОбновлено 19 июля 2026 г.6 мин чтения

Копировать комментарии Facebook в таблицу вручную можно, пока их десять. Этот способ перестает работать, когда под публикацией сотни комментариев, у части нет авторов, в тексте есть эмодзи или переносы строк, а экспорт нужно повторить завтра.

В этом руководстве SocQ Facebook Comments API используется для сбора комментариев по URL публичных публикаций, сохранения нормализованного JSON и создания безопасного CSV для Excel, Google Sheets, аналитики, модерации или архива, пригодного для аудита.

Короткий ответ: отправьте URL публичных публикаций на POST /v1/facebook/comments, сохраните возвращенный ID задачи, опрашивайте ее до завершения и сохраните нормализованные записи комментариев в JSON. CSV создавайте как производный экспорт: один комментарий на строку, кодировка UTF-8, явные ID родительских комментариев и защита от внедрения формул в таблицы.

Три способа экспортировать комментарии Facebook

Ручное копирование

Подходит для нескольких видимых комментариев и разовой задачи. Результат невоспроизводим, стабильные ID не сохраняются, а ответы, авторов, метки времени и вложения сложно проверить.

No-code экспортер

No-code инструменты удобны, когда файл Excel нужен немедленно. Проверьте, какие типы публичных URL поддерживаются, включаются ли ответы и вложения, сколько комментариев можно экспортировать и как поставщик хранит данные.

Процесс на основе API

API лучше подходит для регулярных экспортов, нескольких публикаций, внутренних продуктов, отчетов по расписанию, проверки данных и загрузки в базу. Он требует больше настройки, но дает явное состояние задачи, необработанный JSON, стабильный код преобразования и воспроизводимый результат.

JSON или CSV?

Используйте JSON как основной источник данных. Он сохраняет вложенные структуры:

  • Идентичность author и поля профиля.
  • metrics, например видимое число лайков и ответов.
  • Вложения media.
  • Ссылки extra на исходную публикацию и родительский комментарий.
  • Допустимость null и будущие поля.

CSV — это формат для представления и обмена. Он удобен для Excel, Google Sheets, импорта в BI, проверки розыгрышей, разметки и простого анализа, но вложенные значения приходится разворачивать, а информация о типах может теряться.

Самая надежная схема:

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

Отправка URL публичных публикаций 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"
    ]
  }'

Текущий эндпоинт принимает один или несколько поддерживаемых URL публичных публикаций Facebook. Поисковый запрос, название страницы или URL закрытой группы вместо публичной публикации он не принимает.

Перед отправкой:

  1. Требуйте HTTPS и хост Facebook.
  2. Раскрывайте URL на отдельном контролируемом этапе предобработки, если поддерживаете ссылки «Поделиться».
  3. Удаляйте параметры отслеживания, если это не меняет идентичность публикации.
  4. Удаляйте дубликаты канонических URL.
  5. Сохраняйте исходный ввод для отслеживания происхождения данных.

Опрос асинхронной задачи

Ответ на создание задачи содержит ID задачи. Сохраните его до начала опроса:

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

Считайте queued и running нормальными состояниями. Увеличивайте паузу между запросами. При успехе обрабатывайте записи из data.results.items; если ответ сообщает has_more, продолжайте с его next_cursor.

Сохраняйте входной URL, ID задачи, время отправки, конечный статус, последний зафиксированный курсор и категорию ошибки. Если воркер перезапустится, возобновите существующую задачу, а не создавайте дубликат.

Структура записи комментария

Нормализованная запись выглядит примерно так:

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

Поля могут быть недоступны. Отсутствующий ID автора храните как null, а не как "unknown". Отсутствующее число лайков — это не ноль. replies_count показывает видимое число ответов, если оно доступно; само по себе оно не гарантирует, что текст каждого ответа есть в том же наборе результатов.

Сначала сохраните необработанный JSON

Хранение исходных данных дает журнал аудита и позволяет заново сформировать исправленный CSV без повторного обращения к источнику. Сохраняйте:

  • Поставщика и версию эндпоинта.
  • ID задачи и исходные входные данные.
  • Страницу ответа и курсор.
  • Метку времени сбора.
  • Необработанное тело ответа или пакет записей.
  • Результат проверки и версию преобразования.

Шифруйте хранилище с чувствительными данными, задайте подходящий срок хранения и ограничьте доступ. «Публично видимый» не означает «свободный от обязательств по защите персональных данных».

Экспорт комментариев в CSV на Python

Пример ниже разворачивает записи и защищает ячейки таблицы, которые начинаются с символов формул:

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 записывает метку порядка байтов UTF-8 (BOM), которая помогает распространенным установкам Excel распознать Unicode. Модуль CSV в Python корректно заключает в кавычки запятые, кавычки и переносы строк внутри значений.

Не создавайте CSV, склеивая значения через запятую. Комментарий вполне может содержать все эти символы.

Экспорт на Node.js

Используйте поддерживаемую библиотеку CSV, а не собственное склеивание строк. Преобразование остается тем же:

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

Зафиксируйте версию зависимости для CSV, проверьте итоговое число строк и протестируйте комментарии с эмодзи, запятыми, двойными кавычками, табуляциями, переносами строк и префиксами формул.

Моделирование комментариев и ответов

Используйте comment_id как основной ключ записи. parent_comment_id равен null для комментария верхнего уровня и ссылается на родительский комментарий, если эта связь доступна.

Не используйте отображаемое имя как ключ идентичности. Имена не уникальны и не постоянны. Также не считайте порядок отображения хронологическим: платформы могут ранжировать комментарии и персонализировать видимый порядок.

Для регулярных экспортов выполняйте upsert сущности комментария и добавляйте снимок сбора для изменяемых метрик:

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

Инкрементальный экспорт

Для ежедневного процесса:

  1. Отправьте канонический URL публикации.
  2. Опросите и проверьте завершенную задачу.
  3. Выполните upsert по ID комментария.
  4. Отметьте каждую возвращенную запись значением last_seen_at.
  5. Добавляйте снимки метрик только для успешных сборов.
  6. Формируйте CSV из базы данных или проверенного JSON.
  7. Фиксируйте число отправленных, возвращенных, валидных, новых, обновленных и отклоненных элементов.

Не помечайте ранее найденный комментарий как удаленный после одного неудачного или неполного сбора. Требуйте нескольких успешных наблюдений или отдельной политики проверки.

Проверка экспорта

Проверьте, что:

  • В каждой записи указано platform: facebook и resource: comments.
  • ID, если они есть, уникальны в пределах публикации.
  • Метки времени разбираются единообразно.
  • Счетчики неотрицательны или равны null.
  • ID родителя не указывает на тот же комментарий.
  • Число строк CSV равно числу преобразованных записей.
  • Выборка с эмодзи, многоязычным текстом, кавычками и переносами строк проходит туда и обратно без искажений.
  • Каждая строка сохраняет исходный URL и время сбора.

Сравните вывод API с небольшой публичной выборкой из браузера, но не считайте видимое в браузере число точным эталоном полноты. Комментарии могут ранжироваться, фильтроваться, удаляться, скрываться или меняться между наблюдениями.

Ответственное использование

Собирайте только те публичные комментарии, которые нужны для законной цели. Не обходите вход в аккаунт, закрытые группы, ограничения аудитории или технические средства защиты. Не используйте комментарии для выявления чувствительных характеристик людей или для принятия важных решений о них.

Определите законное основание там, где это требуется, ограничьте срок хранения, защищайте экспорты, контролируйте доступ к таблицам, соблюдайте применимые права на удаление и доступ к данным, изучите актуальные условия Meta и местное законодательство. Это руководство не является юридической консультацией.

Часто задаваемые вопросы

Можно ли экспортировать все комментарии к публикации Facebook?

Ни один поставщик не должен обещать абсолютную полноту. Доступность зависит от публичной публикации, видимого порядка, поведения источника, удалений и покрытия эндпоинта.

Включает ли экспорт ответы?

Нормализованная модель может отражать связи с родительскими комментариями и видимое число ответов. Проверьте, насколько текущий эндпоинт возвращает тексты ответов на вашей выборке, а не предполагайте, что возвращается каждый ответ.

Можно ли экспортировать комментарии из закрытой группы?

Не с помощью этого процесса для публичных данных. Не обходите настройки приватности групп и средства контроля доступа.

Что выбрать: JSON или CSV?

Храните JSON как проверяемый источник и формируйте CSV для таблиц и простого импорта.

Сохранятся ли эмодзи при экспорте?

Да, если весь пайплайн использует UTF-8. В примерах CSV записывается в UTF-8 с BOM для совместимости с Excel.

Зачем защищать префиксы формул?

Табличные программы могут интерпретировать текст комментария, начинающийся с =, +, - или @, как формулу. Префикс в таких ячейках не дает недоверенному тексту выполниться как содержимое таблицы.

Можно ли автоматизировать ежедневный экспорт?

Да. Сохраняйте состояние задачи, используйте увеличивающиеся паузы, удаляйте дубликаты по ID комментария, добавляйте снимки метрик и формируйте файл только из проверенных результатов.

FACEBOOK API

Проверить сценарий на публичном URL Facebook

Отправляйте публичные входные данные и получайте нормализованные записи с отслеживаемым источником.

API для Facebook