Копировать комментарии 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 закрытой группы вместо публичной публикации он не принимает.
Перед отправкой:
- Требуйте HTTPS и хост Facebook.
- Раскрывайте URL на отдельном контролируемом этапе предобработки, если поддерживаете ссылки «Поделиться».
- Удаляйте параметры отслеживания, если это не меняет идентичность публикации.
- Удаляйте дубликаты канонических URL.
- Сохраняйте исходный ввод для отслеживания происхождения данных.
Опрос асинхронной задачи
Ответ на создание задачи содержит 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
Инкрементальный экспорт
Для ежедневного процесса:
- Отправьте канонический URL публикации.
- Опросите и проверьте завершенную задачу.
- Выполните upsert по ID комментария.
- Отметьте каждую возвращенную запись значением
last_seen_at. - Добавляйте снимки метрик только для успешных сборов.
- Формируйте CSV из базы данных или проверенного JSON.
- Фиксируйте число отправленных, возвращенных, валидных, новых, обновленных и отклоненных элементов.
Не помечайте ранее найденный комментарий как удаленный после одного неудачного или неполного сбора. Требуйте нескольких успешных наблюдений или отдельной политики проверки.
Проверка экспорта
Проверьте, что:
- В каждой записи указано
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