API で Facebook ページの投稿を一覧取得: feed、posts、published_posts
Facebook ページの投稿は、Graph API の 3 つのエッジから読み取ります。/{page-id}/feed はページのフィードを返し、訪問者の投稿やページをタグ付けした公開投稿も含みます。/{page-id}/posts はページ自身の投稿を、/{page-id}/published_posts は公開済みの投稿を返します。1 回のリクエストで最大 100 件の投稿を返し、続きはカーソルで取得します。Meta は 1 年あたり約 600 件の、ランキング済みの公開投稿を返します。
easyCoexistence は、Claude、ChatGPT、または独自のコードから list_social_posts で Facebook ページの最近の投稿を一覧し、1 回の呼び出しで最大 100 件を返します。
limit で 1 回のリクエストが読める投稿数の上限です。超えて要求するとエラーが返ります。
ページの投稿を読むとき API が返す、1 年あたりのランキング済み公開投稿数です。
公開済みと未公開の投稿を見分けるフィールドです。feed エッジは両方をまとめて返します。
Meta の feed リファレンスが、ページに公開された Reels を一覧するエッジとして挙げるものです。
ページ送りのリンクです。これが表示されなくなるまで辿ります。短いページや空のページは終わりを示しません。
ページ自身の投稿です。Meta のページリファレンスでは /feed エッジから派生するものとして説明されています。
feed、posts、published_posts の違いは何ですか?
誰が投稿したか、そして投稿がすでに公開されているかどうかです。Meta のページリファレンスは、主要な 3 つのエッジと、より限定的な 3 つのエッジをこの観点で説明しています。また feed は公開済みの投稿と並んで未公開の投稿も返します。その区別は is_published で行います。
どのフィールドを指定するとよいですか?
fields で名前を指定します。Meta 自身の例では、ページの投稿を読むと id、created_time、message が返ります。Page Post のリファレンスでは、投稿のフィールドとして次が挙げられています。
- id、message、
created_time: 投稿、そのテキスト、公開された日時です。 permalink_url: facebook.com 上の投稿の恒久的なアドレスです。full_picture: 添付画像の原寸版です。status_type、is_published、scheduled_publish_timeです。- shares: 投稿が共有された回数を含みます。
- attachments、comments、reactions: 単純なフィールドではなくエッジです。
リアクションとコメントの数はどう取得しますか?
投稿の読み取りでフィールドを展開して取得します。reactions.summary(total_count) でリアクションの総数が加わり、Meta は「いいね」の数に care のリアクションも含まれると注記しています。shares は独自の数を持ちます。summary を要求すると comments エッジは total_count を返します。Meta によれば、これは返されるコメント数を超えることがあり、プライバシーや削除が理由です。
GET /{page-id}/posts?fields=id,message,created_time,permalink_url,shares,reactions.summary(total_count)&limit=25ページ送りはどのように機能しますか?
カーソルによります。各レスポンスには paging があり、before と after のカーソル、そして next と previous のリンクを含みます。next が表示されなくなるまで辿ってください。Meta は、limit より少ない結果のページを終わりと判断しないよう警告しています。ページが空でも next を含むことがあるためです。投稿が追加または削除されるとカーソルはすぐに無効になることがあるため、後で戻ってくる範囲には since と until を使ってください。
どのような制限がありますか?
Meta のフィードリファレンスは、ページの投稿を読む際に次の制限を設けています。
- limit で 1 リクエストあたり 100 件まで。これより大きい値を指定するとエラーになり、100 を超えないよう求められます。
- ランキング済みの公開投稿は 1 年あたり約 600 件です。
- 期限切れの投稿の内容は、Graph API ではもう表示できません。
- 動画投稿の一覧には、リクエストを行う人がページの管理者である必要があります。
- 他人の投稿を共有した投稿は、元の投稿がそのトークンから見えない場合、見えないことがあります。
- 個人の詳細情報は、リクエストがページアクセストークンを使う場合にのみレスポンスに含まれます。
Reels とストーリーはどこで一覧できますか?
それぞれ専用のエッジで一覧できます。Meta のフィードリファレンスは、ページに公開された Reels については、ページの video_reels エッジを指しています。GET /{page-id}/video_reels で since と until を指定して一覧できます。GET /{page-id}/stories はページのストーリーを PUBLISHED または ARCHIVED として一覧します。アーカイブ済みのものは、ページのストーリーアーカイブがオンの間だけ含まれます。
list_social_posts はページに対して何を返しますか?
/{page-id}/posts からページの最近の投稿を返します。既定では 25 件、1 回の呼び出しで最大 100 件です。各投稿は id、message、created_time、permalink_url、full_picture を含み、Meta のページングカーソルも付きます。件数は取得せず、結果の 1 ページ分だけを読み取ります。投稿のコメントは list_social_comments で読み取り、投稿の指標は投稿の ID を object_id として get_social_insights で読み取ります。
easyCoexistence で投稿した投稿はどう一覧しますか?
list_scheduled_posts を使います。これは easyCoexistence を通じて投稿したもの、今すぐ投稿されたものも予約されたものも一覧します。直近のものが先に表示され、ステータスで絞り込むことも、post_id で 1 件だけ取得することもできます。各投稿には、ステータス(scheduled、publishing、processing、published、failed、canceled のいずれか)、publish_at、公開後のリンク、失敗した場合はエラーが付きます。ダッシュボードの投稿画面では、「要対応」「今後」「公開済み」の下に表示されます。
よくある間違い
- list_social_posts から数値を期待すること。このツールは本文、時刻、リンク、画像を読みます。投稿の指標は、投稿の ID を object_id にして get_social_insights で取得します。
- ページ自身の投稿を /feed から読むこと。/feed は訪問者の投稿、ページをタグ付けした公開投稿、未公開の投稿も返します。/published_posts を使うか、is_published で絞り込んでください。
- 短いページを最後のページと見なすこと。next のリンクが消えたときだけ止めてください。Meta は、ページが空でも next を持つことがあると述べています。
- カーソルを後で使うために保存すること。投稿が追加または削除されるとすぐに無効になることがあると Meta は述べています。代わりに since と until の値を保存してください。
list_scheduled_posts は、easyCoexistence を通じて送信された投稿を追跡します。接続 1 件あたり月額 US$ 9 から、接続を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料トライアルです。
よくある質問
フィードエッジには予約投稿も含まれますか?
公開済みと未公開の投稿を一緒に返します。is_published を読めば区別できます。予約された投稿は GET /{page-id}/scheduled_posts で取得できます。
API で別のページの投稿を一覧できますか?
Meta の Page Public Content Access 機能とユーザーアクセストークンがある場合に限ります。easyCoexistence は、接続したページを、それぞれのページトークンで読みます。
日付の範囲で投稿を取得するには?
読み取りに since と until を追加してください。UNIX タイムスタンプまたは strtotime の値で指定できます。Meta のページネーションガイドは、一貫した結果のために両方の指定を推奨しています。
Facebook ページの料金はいくらですか?
接続 1 件あたり月額 US$ 9 から、接続を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料トライアルです。接続したページはそれぞれ 1 件の接続として数えます。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日