Facebook댓글CSVJSONAPI 튜토리얼

Facebook 댓글을 JSON·CSV로 내보내는 방법

API로 공개 Facebook 게시물 댓글을 수집하고, 정규화된 JSON을 보존하고, Excel·Google Sheets·분석·보관용으로 안전한 UTF-8 CSV 파일을 만드는 방법을 알려 드립니다.

SocQ2026년 7월 19일 업데이트약 8분 소요

Facebook 댓글을 스프레드시트에 복사해 붙여 넣는 방법은 댓글이 열 개 정도일 때나 통합니다. 게시물에 댓글이 수백 개이거나, 작성자 정보가 빠져 있거나, 텍스트에 이모지와 줄바꿈이 섞여 있거나, 내일 같은 내보내기를 반복해야 한다면 한계에 부딪힙니다.

이 튜토리얼에서는 SocQ Facebook Comments API로 공개 게시물 URL의 댓글을 수집하고, 정규화된 JSON을 보존하고, Excel·Google Sheets·분석·모더레이션·감사 가능한 아카이브에 쓸 수 있는 안전한 CSV를 만드는 방법을 설명합니다.

빠른 답변: 공개 게시물 URL을 POST /v1/facebook/comments에 보내고, 반환된 작업 ID를 저장한 뒤, 완료될 때까지 폴링하고, 정규화된 댓글 레코드를 JSON으로 저장하세요. CSV는 파생 내보내기로 만들고, 댓글 하나를 한 행에 담고, UTF-8 인코딩과 명시적인 부모 ID를 사용하며, 스프레드시트 수식 삽입 공격에 대비하세요.

Facebook 댓글을 내보내는 세 가지 방법

수동 복사·붙여넣기

화면에 보이는 몇 개의 댓글을 한 번만 옮길 때는 괜찮습니다. 하지만 재현할 수 없고, 안정적인 ID가 보존되지 않으며, 답글·작성자·타임스탬프·첨부 파일을 감사하기도 어렵습니다.

노코드 내보내기 도구

사람이 당장 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

공개 Facebook 게시물 URL 보내기

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"
    ]
  }'

현재 이 엔드포인트는 지원되는 공개 Facebook 게시물 URL을 하나 이상 받습니다. 검색어, 페이지 이름, 비공개 그룹 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가 없으면 "unknown"이 아니라 null로 보관하세요. 좋아요 수가 없는 것은 0이 아닙니다. replies_count는 가능한 경우 화면에 표시되는 수를 알려 줄 뿐이며, 같은 결과 집합에 모든 답글 본문이 들어 있다는 것을 보장하지는 않습니다.

원본 JSON부터 저장하기

원본을 저장해 두면 감사 기록이 남고, 원본을 다시 호출하지 않고도 수정된 CSV를 다시 만들 수 있습니다. 다음을 저장하세요.

  • 업체와 엔드포인트 버전.
  • 작업 ID와 원래 입력.
  • 응답 페이지와 커서.
  • 수집 타임스탬프.
  • 원본 응답 본문 또는 레코드 배치.
  • 검증 결과와 변환 버전.

민감한 저장소는 암호화하고, 적절한 보관 기간을 적용하고, 접근을 제한하세요. "공개적으로 보인다"는 것이 "개인정보 보호 의무가 없다"는 뜻은 아닙니다.

Python으로 댓글을 CSV로 내보내기

아래 예제는 레코드를 평탄화하고, 수식 문자로 시작하는 스프레드시트 셀을 보호합니다.

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 환경이 유니코드를 인식하도록 돕습니다. Python의 CSV writer는 쉼표, 따옴표, 내부 줄바꿈을 올바르게 이스케이프합니다.

값을 쉼표로 이어 붙여 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. 댓글 ID 기준으로 upsert합니다.
  4. 반환된 모든 레코드에 last_seen_at을 기록합니다.
  5. 성공한 수집에 대해서만 지표 스냅샷을 추가합니다.
  6. 데이터베이스 또는 검증된 JSON에서 CSV를 생성합니다.
  7. 제출, 반환, 유효, 신규, 갱신, 거부된 항목의 개수를 기록합니다.

수집이 한 번 실패하거나 불완전했다고 해서 이전에 확인된 댓글을 삭제된 것으로 표시하지 마세요. 여러 번의 성공적인 관측이나 별도의 검증 정책이 필요합니다.

내보내기 검증

다음을 확인하세요.

  • 모든 레코드가 platform: facebook과 resource: comments입니다.
  • 값이 있는 경우 게시물 내에서 ID가 고유합니다.
  • 타임스탬프가 일관되게 파싱됩니다.
  • 수치는 음수가 아니거나 null입니다.
  • 부모 ID가 자기 자신을 가리키지 않습니다.
  • CSV 행 수가 변환된 레코드 수와 같습니다.
  • 이모지, 다국어 텍스트, 따옴표, 줄바꿈 샘플이 왕복 변환 후에도 올바릅니다.
  • 모든 행에 출처 URL과 수집 시각이 남아 있습니다.

API 출력을 브라우저에서 확인한 소량의 공개 샘플과 비교해 보되, 브라우저에 표시되는 개수를 완전성의 정확한 기준으로 삼지는 마세요. 댓글은 관측 사이에 순위가 매겨지거나, 필터링되거나, 삭제되거나, 숨겨지거나, 바뀔 수 있습니다.

책임 있는 사용

정당한 목적에 필요한 공개 댓글만 수집하세요. 로그인, 비공개 그룹, 공개 대상 제한, 기술적 통제를 우회하지 마세요. 댓글로 민감한 특성을 추론하거나 사람에 대한 영향이 큰 결정을 내리지 마세요.

필요한 경우 적법한 처리 근거를 정하고, 보관 기간을 제한하고, 내보낸 파일을 안전하게 보관하고, 스프레드시트 공유를 통제하고, 해당하는 삭제·열람 권리를 존중하며, Meta의 최신 약관과 현지 법률을 검토하세요. 이 튜토리얼은 법률 자문이 아닙니다.

자주 묻는 질문(FAQ)

Facebook 게시물의 모든 댓글을 내보낼 수 있나요?

어떤 업체도 완전한 수집을 약속해서는 안 됩니다. 수집 가능 여부는 공개 게시물, 표시되는 순서, 원본 플랫폼의 동작, 삭제, 엔드포인트 지원 범위에 따라 달라집니다.

내보내기에 답글도 포함되나요?

정규화된 모델은 부모 관계와 표시되는 답글 수를 표현할 수 있습니다. 모든 답글이 반환된다고 가정하지 말고, 현재 엔드포인트의 답글 본문 지원 범위를 샘플로 직접 확인하세요.

비공개 그룹의 댓글도 내보낼 수 있나요?

이 공개 데이터 워크플로로는 불가능합니다. 그룹의 개인정보 보호나 접근 제어를 우회하지 마세요.

JSON과 CSV 중 무엇을 선택해야 하나요?

JSON은 감사 가능한 원본으로 유지하고, 스프레드시트와 간단한 가져오기용으로 CSV를 생성하세요.

이모지도 그대로 내보내지나요?

네, 파이프라인 전체가 UTF-8을 사용하면 그렇습니다. 예제는 Excel 호환을 위해 BOM이 있는 UTF-8 CSV를 씁니다.

수식 접두사는 왜 보호해야 하나요?

스프레드시트 소프트웨어는 =, +, -, @로 시작하는 댓글 텍스트를 수식으로 해석할 수 있습니다. 해당 셀에 접두사를 붙이면 신뢰할 수 없는 텍스트가 스프레드시트 콘텐츠로 실행되는 것을 막을 수 있습니다.

내보내기를 매일 자동화할 수 있나요?

네. 작업 상태를 저장하고, 백오프를 사용하고, 댓글 ID로 중복을 제거하고, 지표 스냅샷을 추가하고, 검증된 결과로만 파일을 생성하세요.

FACEBOOK API

공개 Facebook URL로 워크플로를 테스트하세요

공개 데이터 입력을 제출하면 출처를 추적할 수 있는 컨텍스트가 포함된 정규화된 레코드를 받을 수 있습니다.

Facebook API 살펴보기