FacebookコメントCSVJSONAPIチュートリアル

FacebookのコメントをJSON・CSVにエクスポートする方法

APIで公開Facebook投稿のコメントをエクスポートし、正規化されたJSONを保存して、Excel、スプレッドシート、分析、アーカイブ向けに安全なUTF-8のCSVを作成します。

SocQ2026年7月19日更新約10分で読めます

Facebookのコメントをスプレッドシートにコピーする方法は、10件程度なら通用します。しかし、投稿に数百件のコメントがある場合、投稿者が欠けている場合、本文に絵文字や改行が含まれる場合、そして明日も同じエクスポートを繰り返す必要がある場合には、うまくいきません。

このチュートリアルでは、SocQ Facebook Comments APIを使って、公開投稿のURLからコメントを収集し、正規化されたJSONを保存して、Excel、Googleスプレッドシート、分析、モデレーション、監査可能なアーカイブ向けに安全なCSVを生成します。

ひとことで言うと: 公開投稿のURLを POST /v1/facebook/comments に送信し、返されたタスクIDを保存して、完了するまでポーリングし、正規化されたコメントのレコードをJSONとして保存します。CSVは派生したエクスポートとして作成し、1コメントを1行、エンコーディングをUTF-8とし、親IDを明示して、スプレッドシートの数式インジェクションから保護します。

Facebookのコメントをエクスポートする3つの方法

手作業でのコピー&ペースト

表示されている少数のコメントを1回だけ扱うなら、妥当な方法です。ただし、再現性がなく、安定したIDも保持されず、返信、投稿者、タイムスタンプ、添付ファイルの監査も困難です。

ノーコードのエクスポートツール

人がすぐにExcelファイルを必要とする場合には、ノーコードのツールが便利です。どの種類の公開URLに対応しているか、返信や添付ファイルが含まれるか、何件までコメントをエクスポートできるか、プロバイダーがデータをどのように保存するかを確認してください。

APIを使ったワークフロー

定期的なエクスポート、複数の投稿、社内プロダクト、スケジュールされたレポート、検証、データベースへの読み込みには、APIのほうが適しています。セットアップの手間は増えますが、明示的なタスクの状態、生のJSON、安定した変換コード、再現可能な出力が得られます。

JSONとCSV、どちらを使うか

JSONは、信頼できる情報源(source of truth)として保持してください。入れ子の構造が保たれます。

  • author のIDとプロフィールのフィールド。
  • 表示されているいいね数や返信数などの metrics。
  • 添付ファイルの media。
  • 元の投稿と親コメントを参照する extra。
  • null許容の扱いと、将来追加されるフィールド。

CSVは、表示と受け渡しのための形式です。Excel、Googleスプレッドシート、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"
    ]
  }'

現在のエンドポイントは、対応している1件以上の公開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のバイトオーダーマークを書き込むため、一般的なExcelの環境でUnicodeを認識しやすくなります。PythonのCSVライターは、カンマ、引用符、コメント内の改行を正しくクォートします。

値をカンマで連結して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で、親子関係が取得できる場合は親を参照します。

表示名をIDのキーとして使わないでください。名前は一意でも恒久的でもありません。同様に、表示順が時系列だと思い込まないでください。プラットフォームは、コメントをランキングしたり、表示順をパーソナライズしたりすることがあります。

定期的なエクスポートでは、コメントのエンティティをアップサートし、変化する指標については収集時点のスナップショットを追加します。

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でアップサートする。
  4. 返されたすべてのレコードに、last_seen_at を記録する。
  5. 収集が成功した場合に限り、指標のスナップショットを追加する。
  6. データベースまたは検証済みのJSONから、CSVを生成する。
  7. 送信、返却、有効、新規、更新、却下の各件数を記録する。

収集が1回失敗した、または不完全だったからといって、以前に確認したコメントを削除済みとしてマークしないでください。複数回の成功した観測、または別途の確認ポリシーを必須にしてください。

エクスポートを検証する

次の点を確認してください。

  • すべてのレコードが、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を見る