ログイン無料トライアルを開始
easyCoexistence 公式 API

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 件を返します。

100

limit で 1 回のリクエストが読める投稿数の上限です。超えて要求するとエラーが返ります。

About 600

ページの投稿を読むとき API が返す、1 年あたりのランキング済み公開投稿数です。

is_published

公開済みと未公開の投稿を見分けるフィールドです。feed エッジは両方をまとめて返します。

video_reels

Meta の feed リファレンスが、ページに公開された Reels を一覧するエッジとして挙げるものです。

next

ページ送りのリンクです。これが表示されなくなるまで辿ります。短いページや空のページは終わりを示しません。

posts

ページ自身の投稿です。Meta のページリファレンスでは /feed エッジから派生するものとして説明されています。

feed、posts、published_posts の違いは何ですか?

誰が投稿したか、そして投稿がすでに公開されているかどうかです。Meta のページリファレンスは、主要な 3 つのエッジと、より限定的な 3 つのエッジをこの観点で説明しています。また feed は公開済みの投稿と並んで未公開の投稿も返します。その区別は is_published で行います。

feedThe Page's feed: its own posts and links, visitors' posts and public posts tagging it
postsThe Page's own posts, a derivative of /feed
published_postsPublished posts by the Page
scheduled_postsPosts the Page scheduled to a future date
visitor_postsPublic posts published by visitors on the Page
taggedPhotos, videos and posts in which the Page is tagged

どのフィールドを指定するとよいですか?

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 によれば、これは返されるコメント数を超えることがあり、プライバシーや削除が理由です。

Reading posts with share and reaction counts
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 の値を保存してください。
EasyCoexistence で実現する

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 監視

確認日