プラットフォームの稼働状況
- 24時間の稼働状況
- 87%
過去30日間
利用可能な機能
Facebookの各アクションについて、内容、料金、過去24時間の稼働状況を掲載しています。アクションを開くと、パラメータ、レスポンスフィールド、コードサンプルを確認できます。
| 機能 | できること | 1,000リクエストあたり | 24時間の稼働状況 |
|---|---|---|---|
検索search | keywordでFacebook投稿を検索し、各投稿の本文、投稿者、いいね数、コメント数、シェア数、投稿日時を取得します。日付範囲は任意で指定できます。content_typeはメディアの絞り込みではなく、新しい順または人気順の並べ替えに使います。プライベートメッセージは検索対象外です。 | 1,000リクエストあたり$1610行ごとに1回の呼び出しとしてカウントされます | 良好・稼働状況100% |
詳細profile | urlからFacebookページまたは公開プロフィールを取得します。カテゴリ、自己紹介、いいね数、フォロワー数、認証バッジ、表示されている連絡先情報が含まれます。電話番号とメールアドレスはページに表示されているもののみです。本人確認や利用許可を意味するものではありません。 | 1,000リクエストあたり$2.78 | 正常 |
ユーザーの投稿user_posts | urlのFacebookページまたはアカウントから投稿を一覧表示します。各投稿には本文、投稿者、投稿日時、いいね数・コメント数・シェア数が含まれます。結果がタイムライン全体を網羅しているとは限りません。 | 1,000リクエストあたり$2.78 | 正常 |
投稿詳細post | urlからFacebook投稿1件を取得し、本文、投稿者、投稿日時、いいね数・コメント数・シェア数を返します。コメント、リアクションの詳細、非公開コンテンツは含まれません。スレッドを取得するにはcommentsを使用してください。 | 1,000リクエストあたり$1.39 | 利用可能・稼働状況80% |
コメントcomments | urlからFacebook投稿のコメントを取得します。各コメントには投稿者、投稿者ID、いいね数、返信数、投稿日時、パーマリンクが含まれます。返信行は親グループのIDを再利用するため、スレッドはdepthとreply_to_idで再構築してください。完全なツリーを取得できるとは限りません。 | 1,000リクエストあたり$2.78 | 正常 |
フォロワーfollowers | usernameを指定して、Facebookアカウントまたはページのフォロワー数、フォロー数、投稿数、いいね数を確認します。概数の値には精度フラグが付きます。返されるのは合計値のみで、個々のフォロワーの一覧は含まれません。 | 1,000リクエストあたり$1.39 | 正常 |
広告ads | keywordまたはFacebook広告ライブラリのURLで、広告ライブラリの広告を検索します。広告文、CTA、ランディングページ、配信期間、掲載面、広告主を取得できます。国とstatusで絞り込めます。費用、インプレッション、ターゲティング、コンバージョンは含まれません。 | 1,000リクエストあたり$1.39 | 正常 |
グループの投稿group_posts | グループのurlまたは識別子から、Facebookグループの投稿を取得します。本文、投稿者、投稿日時、いいね数・コメント数・シェア数を取得できます。sortで人気の投稿または最近アクティビティがあった投稿を選べます。「最近のアクティビティ」は投稿の作成日時ではなく、アクティビティの発生日時に基づきます。すべての投稿を網羅できるとは限りません。 | 1,000リクエストあたり$1.39 | 正常 |
マーケットプレイスmarketplace | 1つの都市を対象に、商品のkeywordでFacebook Marketplaceの出品を閲覧します。価格、通貨、市区町村、州、状態、画像、投稿日時を取得できます。locationには番地ではなく、nyc（デフォルト）のような都市パスを指定します。在庫状況は確認されません。 | 1,000リクエストあたり$1.39 | 正常 |
レビューreviews | Facebookページのurlから、おすすめとレビューを収集します。本文、おすすめするかどうか、評価（ある場合）、投稿者、投稿日時を取得できます。Facebookでは星評価の代わりに「おすすめする」「おすすめしない」を使用するため、星評価がなくてもおすすめが無効になるわけではありません。 | 1,000リクエストあたり$1.39 | 正常 |
広告主検索advertiser_search | 広告ライブラリで、ブランド名または広告主名で広告を出稿しているFacebookページを、1回の呼び出しで最大15件検索します。各ページにはID、名前、ユーザー名、カテゴリ、認証フラグ、ページのいいね数、リンクされたInstagramアカウントとそのフォロワー数が含まれます。nikeで検索すると、Nike（ページID 15087023444）が最初に表示されます。ページングはありません。 | 1,000リクエストあたり$0.88 | 正常 |
広告詳細ad_detail | リンクまたは広告ライブラリIDから、Facebook広告ライブラリの広告を1件開きます。配信中かどうか、開始日と終了日、広告テキスト、見出し、リンクとCTA、表示形式、配信された掲載面、画像または動画、すべてのクリエイティブバリエーション、広告主のページID・名前・いいね数・カテゴリを取得できます。費用、リーチ、ターゲティングは結果に含まれません。 | 1,000リクエストあたり$0.96 | 正常 |
イベント検索events_search | music festivalのようなkeywordで公開Facebookイベントを検索します。各イベントには名前、開始日時、Facebookに表示される日付、会場、オンラインフラグ、開催済みかどうか、参加予定数と興味ありの数、表示されている場合はチケット価格のテキスト、カバー画像が含まれます。過去のイベントも含まれます。1ページあたり約5件で、続きはnext_page_tokenで取得します。 | 1,000リクエストあたり$0.96 | 正常 |
マーケットプレイスの出品詳細marketplace_item | Facebook Marketplaceの出品1件を、リンクまたは数値IDから取得します。タイトル、説明、価格と元の価格、通貨、状態、商品属性、座標付きの所在地、出品日時、売約済み・取引中フラグ、配送・受け渡しオプション、写真、出品者の名前・評価・評価数・登録日を取得できます。 | 1,000リクエストあたり$0.96 | 正常 |
ページのイベントpage_events | 公開Facebookページのリンクから、そのページが主催する今後および過去のイベントを一覧表示します。各イベントには名前、開始日時、会場、都市、主催者、およびオンライン・開催済み・キャンセルのフラグが含まれます。1ページあたり最大10件で件数は変動し、続きはnext_page_tokenで取得します。イベントを主催していないページの場合は空のリストが返ります。 | 1,000リクエストあたり$0.96 | 正常 |
動画投稿の文字起こしpost_transcript | 公開Facebook動画、リール、動画投稿の音声を、リンクからテキストに変換します。文字起こしと動画の長さ（秒）を取得できます。誰も話していない動画ではtextは返されません。 | 1,000リクエストあたり$0.96 | 正常 |
機能を開くと、パラメータ、レスポンスフィールド、コードサンプル、トライアルを確認できます。
Facebookの各アクションではどのような入力を指定できますか？
以下の各回答では、呼び出し可能なアクション1つとその実際の入力を対応付けています。パラメータの意味と指定可能な値はアクションごとに異なります。同じ名前でも、すべてのプラットフォームで同じ意味になるとは限りません。
公式情報源へのリンクは、横に記載したプラットフォーム用語を説明する目的でのみ掲載しています。プラットフォームによる認可や推奨を意味するものではありません。また、このページに記載がない限り、公式サイトの機能はEveryInfra APIには含まれません。
| アクション | 必須 | 任意 | 提供方式 | 上限 | 1,000件あたり | レスポンスフィールド |
|---|---|---|---|---|---|---|
search検索
| keyword | content_type, since, until | Sync配信 | カタログ値：defaultLimit=10、maxLimit=200。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1610行ごとに1回の呼び出しとしてカウントされます | id · url · text · author_name · author_username · author_id · author_url · author_avatar_url · media · reactions · view_count · link · group_name · is_paid_partnership · like_count · comment_count · share_count · posted_at · platform |
profile詳細
| url | — | Async配信 | — | 1,000リクエストあたり$2.78 | id · name · url · bio · category · like_count · follower_count · is_verified · phone · email · website · rating · rating_scale · avatar_url · platform |
user_postsユーザーの投稿
| url | — | Async配信 | カタログ値：defaultLimit=10、maxLimit=50。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$2.78 | id · url · text · author_name · author_username · author_id · author_url · author_avatar_url · media · reactions · view_count · link · group_name · is_paid_partnership · like_count · comment_count · share_count · posted_at · platform |
post投稿詳細
| url | — | Sync配信 | — | 1,000リクエストあたり$1.39 | id · url · text · author_name · author_username · author_id · author_url · author_avatar_url · media · reactions · view_count · link · group_name · is_paid_partnership · like_count · comment_count · share_count · posted_at · platform |
commentsコメント
| url | — | Async配信 | カタログ値：defaultLimit=10、maxLimit=50。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$2.78 | id · text · author_name · author_username · depth · reply_to_id · comment_url · author_id · author_url · like_count · reply_count · posted_at · platform |
followersフォロワー
| username | channel | Sync配信 | — | 1,000リクエストあたり$1.39 | id · username · url · follower_count · following_count · post_count · like_count · connection_count · precision · platform |
ads広告
| keyword | country, status | Sync配信 | カタログ値：defaultLimit=20、maxLimit=200。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | id · url · text · title · cta_text · link_url · is_active · started_at · ended_at · platforms · variant_count · advertiser_id · advertiser_name · advertiser_url · advertiser_likes · image_url · platform |
group_postsグループの投稿 グループの | url | sort | Sync配信 | カタログ値：defaultLimit=20、maxLimit=200。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | id · url · text · posted_at · like_count · comment_count · share_count · author_id · author_name · author_url · group_url · platform |
marketplaceマーケットプレイス 1つの都市を対象に、商品の | keyword | location | Sync配信 | カタログ値：defaultLimit=20、maxLimit=200。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | id · url · name · price · currency · city · state · condition · image_url · posted_at · platform |
reviewsレビュー Facebookページの | url | — | Sync配信 | カタログ値：defaultLimit=20、maxLimit=200。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | id · url · text · is_recommended · rating · rating_scale · posted_at · like_count · comment_count · author_id · author_name · author_url · platform |
advertiser_search広告主検索 広告ライブラリで、ブランド名または広告主名で広告を出稿しているFacebookページを、1回の呼び出しで最大15件検索します。各ページにはID、名前、ユーザー名、カテゴリ、認証フラグ、ページのいいね数、リンクされたInstagramアカウントとそのフォロワー数が含まれます。nikeで検索すると、Nike（ページID 15087023444）が最初に表示されます。ページングはありません。 | keyword | — | Sync配信 | カタログ値：defaultLimit=15、maxLimit=15。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。より大きいlimitも指定できますが、15が上限として適用されます。 | 1,000リクエストあたり$0.88 | id · name · username · url · category · avatar_url · page_like_count · is_verified · instagram_username · instagram_follower_count · instagram_verified · country · platform |
ad_detail広告詳細 リンクまたは広告ライブラリIDから、Facebook広告ライブラリの広告を1件開きます。配信中かどうか、開始日と終了日、広告テキスト、見出し、リンクとCTA、表示形式、配信された掲載面、画像または動画、すべてのクリエイティブバリエーション、広告主のページID・名前・いいね数・カテゴリを取得できます。費用、リーチ、ターゲティングは結果に含まれません。 | url | — | Sync配信 | — | 1,000リクエストあたり$0.96 | id · url · is_active · started_at · ended_at · text · title · caption · link_url · link_description · cta_text · display_format · platforms · media · creatives · variant_count · advertiser_id · advertiser_name · advertiser_url · advertiser_likes · advertiser_avatar_url · advertiser_categories · platform |
events_searchイベント検索
| keyword | page_token | Sync配信 | 1回の呼び出しで最大5行の1ページを返します。行数はページごとに異なるため、行数が少なくても最後のページとは限りません。次のページを取得するには、レスポンスのトップレベルにあるnext_page_tokenをpage_tokenとして渡し、next_page_tokenがなくなったら終了します。limitは指定できますが、効果はありません。 | 1,000リクエストあたり$0.96 | id · url · name · starts_at · date_text · place_name · place_id · is_online · is_past · going_count · interested_count · price_text · image_url · next_page_token · platform |
marketplace_itemマーケットプレイスの出品詳細 Facebook Marketplaceの出品1件を、リンクまたは数値IDから取得します。タイトル、説明、価格と元の価格、通貨、状態、商品属性、座標付きの所在地、出品日時、売約済み・取引中フラグ、配送・受け渡しオプション、写真、出品者の名前・評価・評価数・登録日を取得できます。 | url | — | Sync配信 | — | 1,000リクエストあたり$0.96 | id · url · title · text · price · price_text · original_price_text · currency · condition · attributes · location · latitude · longitude · posted_at · is_sold · is_pending · is_shipping_offered · delivery_types · category_id · image_urls · seller_id · seller_name · seller_rating · seller_rating_count · seller_joined_at · platform |
page_eventsページのイベント 公開Facebookページのリンクから、そのページが主催する今後および過去のイベントを一覧表示します。各イベントには名前、開始日時、会場、都市、主催者、およびオンライン・開催済み・キャンセルのフラグが含まれます。1ページあたり最大10件で件数は変動し、続きは | url | page_token | Sync配信 | 1回の呼び出しで最大10行の1ページを返します。行数はページごとに異なるため、行数が少なくても最後のページとは限りません。次のページを取得するには、レスポンスのトップレベルにあるnext_page_tokenをpage_tokenとして渡し、next_page_tokenがなくなったら終了します。limitは指定できますが、効果はありません。 | 1,000リクエストあたり$0.96 | id · url · name · starts_at · date_text · place_name · city · host_name · is_online · is_past · is_canceled · next_page_token · platform |
post_transcript動画投稿の文字起こし 公開Facebook動画、リール、動画投稿の音声を、リンクからテキストに変換します。文字起こしと動画の長さ（秒）を取得できます。誰も話していない動画では | url | — | Sync配信 | — | 1,000リクエストあたり$0.96 | id · url · text · duration_seconds · duration_sec · platform |
Facebookのsearchのパラメータはそれぞれどういう意味ですか？
keywordでFacebook投稿を検索し、各投稿の本文、投稿者、いいね数、コメント数、シェア数、投稿日時を取得します。日付範囲は任意で指定できます。content_typeはメディアの絞り込みではなく、新しい順または人気順の並べ替えに使います。プライベートメッセージは検索対象外です。
keyword必須- プラットフォームの各エンドポイントで使用する検索クエリを指定します。searchでは公開投稿を検索し、adsでは広告のキーワード、または広告ライブラリやページのURLを直接指定できます。marketplaceでは商品の検索語、またはMarketplaceの検索URL全体を指定できます。各アクションは異なるデータセットを検索するため、同じ結果がフィールド名だけ変えて返されるわけではありません。
content_type任意- searchアクションの結果の並び順を指定します。指定できる値はlatest（新しい投稿順）またはmost_popular（人気の投稿順）です。名前に反してcontent_typeは並び替えの基準として機能し、画像や動画などのメディア形式による絞り込みは行いません。指定可能な値:
latestmost_popularFacebook：公開投稿と公開情報の範囲 — Facebookのヘルプドキュメントでは、公開設定でシェアされたコンテンツ、ページの投稿、公開投稿へのコメントの公開範囲を定義しています。これは検索の対象となるオブジェクトを明確にするものであり、`content_type`のランキング値を裏付けるものでも、公開されている情報の自動収集が許可されていることを示すものでもありません。 · 確認日 since任意- searchアクションで、この開始日以降に公開された投稿に絞り込みます。YYYY-MM-DD形式を推奨します。untilと組み合わせて検索の日付範囲を指定します。広告の配信期間やコメントの作成日時による絞り込みは行いません。
until任意- searchアクションで、この終了日までに公開された投稿に絞り込みます。YYYY-MM-DD形式を推奨します。sinceと組み合わせて検索の日付範囲を指定します。広告の終了日は制御しません。
Facebookのprofileのパラメータはそれぞれどういう意味ですか？
urlからFacebookページまたは公開プロフィールを取得します。カテゴリ、自己紹介、いいね数、フォロワー数、認証バッジ、表示されている連絡先情報が含まれます。電話番号とメールアドレスはページに表示されているもののみです。本人確認や利用許可を意味するものではありません。
url必須- リクエストするアクションに対応する対象URLを指定します。profileとuser_postsには公開ページのURL、postとcommentsには投稿のURL、group_postsにはグループページのURLまたはグループID、reviewsにはビジネスページのURLを指定します（reviewsでは末尾に/reviewsが付加されます）。任意のFacebook URLをアクション間で使い回すことはできません。Facebook公式：ページのプロフィール、投稿、コメントの公開範囲 — Metaの公式ドキュメントでは、ページ、プロフィール、投稿、コメントにおける公開情報について説明しています。この公開範囲の定義は、すべてのURLを読み取れること、すべてのフィールドが返されること、このエンドポイントがMetaのアクセス許可を得ていることのいずれも保証するものではありません。 · 確認日Meta公式ドキュメント：自動データ収集には事前の許可が必要 — Metaは、公開されているデータであっても、事前の許可なくFacebookのデータを自動収集することは規約違反であると明記しています。信頼できる情報源を引用しても、本プラットフォームによるデータの収集や再利用が許可されていることの証明にはなりません。 · 確認日
Facebookのuser_postsのパラメータはそれぞれどういう意味ですか？
urlのFacebookページまたはアカウントから投稿を一覧表示します。各投稿には本文、投稿者、投稿日時、いいね数・コメント数・シェア数が含まれます。結果がタイムライン全体を網羅しているとは限りません。
url必須- リクエストするアクションに対応する対象URLを指定します。profileとuser_postsには公開ページのURL、postとcommentsには投稿のURL、group_postsにはグループページのURLまたはグループID、reviewsにはビジネスページのURLを指定します（reviewsでは末尾に/reviewsが付加されます）。任意のFacebook URLをアクション間で使い回すことはできません。Facebook公式：ページのプロフィール、投稿、コメントの公開範囲 — Metaの公式ドキュメントでは、ページ、プロフィール、投稿、コメントにおける公開情報について説明しています。この公開範囲の定義は、すべてのURLを読み取れること、すべてのフィールドが返されること、このエンドポイントがMetaのアクセス許可を得ていることのいずれも保証するものではありません。 · 確認日Meta公式ドキュメント：自動データ収集には事前の許可が必要 — Metaは、公開されているデータであっても、事前の許可なくFacebookのデータを自動収集することは規約違反であると明記しています。信頼できる情報源を引用しても、本プラットフォームによるデータの収集や再利用が許可されていることの証明にはなりません。 · 確認日
Facebookのpostのパラメータはそれぞれどういう意味ですか？
urlからFacebook投稿1件を取得し、本文、投稿者、投稿日時、いいね数・コメント数・シェア数を返します。コメント、リアクションの詳細、非公開コンテンツは含まれません。スレッドを取得するにはcommentsを使用してください。
url必須- リクエストするアクションに対応する対象URLを指定します。profileとuser_postsには公開ページのURL、postとcommentsには投稿のURL、group_postsにはグループページのURLまたはグループID、reviewsにはビジネスページのURLを指定します（reviewsでは末尾に/reviewsが付加されます）。任意のFacebook URLをアクション間で使い回すことはできません。Facebook公式：ページのプロフィール、投稿、コメントの公開範囲 — Metaの公式ドキュメントでは、ページ、プロフィール、投稿、コメントにおける公開情報について説明しています。この公開範囲の定義は、すべてのURLを読み取れること、すべてのフィールドが返されること、このエンドポイントがMetaのアクセス許可を得ていることのいずれも保証するものではありません。 · 確認日Meta公式ドキュメント：自動データ収集には事前の許可が必要 — Metaは、公開されているデータであっても、事前の許可なくFacebookのデータを自動収集することは規約違反であると明記しています。信頼できる情報源を引用しても、本プラットフォームによるデータの収集や再利用が許可されていることの証明にはなりません。 · 確認日
Facebookのcommentsのパラメータはそれぞれどういう意味ですか？
urlからFacebook投稿のコメントを取得します。各コメントには投稿者、投稿者ID、いいね数、返信数、投稿日時、パーマリンクが含まれます。返信行は親グループのIDを再利用するため、スレッドはdepthとreply_to_idで再構築してください。完全なツリーを取得できるとは限りません。
url必須- リクエストするアクションに対応する対象URLを指定します。profileとuser_postsには公開ページのURL、postとcommentsには投稿のURL、group_postsにはグループページのURLまたはグループID、reviewsにはビジネスページのURLを指定します（reviewsでは末尾に/reviewsが付加されます）。任意のFacebook URLをアクション間で使い回すことはできません。Facebook公式：ページのプロフィール、投稿、コメントの公開範囲 — Metaの公式ドキュメントでは、ページ、プロフィール、投稿、コメントにおける公開情報について説明しています。この公開範囲の定義は、すべてのURLを読み取れること、すべてのフィールドが返されること、このエンドポイントがMetaのアクセス許可を得ていることのいずれも保証するものではありません。 · 確認日Meta公式ドキュメント：自動データ収集には事前の許可が必要 — Metaは、公開されているデータであっても、事前の許可なくFacebookのデータを自動収集することは規約違反であると明記しています。信頼できる情報源を引用しても、本プラットフォームによるデータの収集や再利用が許可されていることの証明にはなりません。 · 確認日
Facebookのfollowersのパラメータはそれぞれどういう意味ですか？
usernameを指定して、Facebookアカウントまたはページのフォロワー数、フォロー数、投稿数、いいね数を確認します。概数の値には精度フラグが付きます。返されるのは合計値のみで、個々のフォロワーの一覧は含まれません。
username必須- followersアクションで対象とするFacebookアカウントまたはページのIDを、@を付けずに指定します。この機能はフォロワー総数のオブジェクトを返すもので、個々のフォロワーのプロフィール一覧やユーザー間のつながりのグラフを出力するものではありません。Facebook：ページのフォローと「いいね！」の違い — Facebookの公式ドキュメントでは、フォローはページの最新情報を受け取るためのものであることを説明し、「いいね！」からフォローの仕組みに移行中のページにおける違いについても触れています。これにより、`follower_count`と`like_count`を区別できますが、このプラットフォームでフォロワーリストをエクスポートできることを示すものではありません。 · 確認日
channel任意- followersアクションのアカウントIDとの互換性のために使用するパラメータです。usernameを指定した場合はusernameが優先されます。また、公開リクエストには引き続き必須のusernameパラメータを含める必要があります。このパラメータはチャットのチャンネルIDではありません。
Facebookのadsのパラメータはそれぞれどういう意味ですか？
keywordまたはFacebook広告ライブラリのURLで、広告ライブラリの広告を検索します。広告文、CTA、ランディングページ、配信期間、掲載面、広告主を取得できます。国とstatusで絞り込めます。費用、インプレッション、ターゲティング、コンバージョンは含まれません。
keyword必須- プラットフォームの各エンドポイントで使用する検索クエリを指定します。searchでは公開投稿を検索し、adsでは広告のキーワード、または広告ライブラリやページのURLを直接指定できます。marketplaceでは商品の検索語、またはMarketplaceの検索URL全体を指定できます。各アクションは異なるデータセットを検索するため、同じ結果がフィールド名だけ変えて返されるわけではありません。Meta公式：広告ライブラリにおける広告とページの検索対象 — Metaの過去の発表では、キーワードやページによる広告検索が紹介され、一般の配信中広告と政治・社会問題に関する広告とで透明性データが異なる点や、公式APIの利用要件が示されています。ただし、これはすべての広告に消化金額、インプレッション数、完全な履歴が含まれることを意味するものではありません。このエンドポイントは、これらのフィールドを安定して提供していないためです。 · 確認日
country任意- adsアクションのキーワード検索で使用する国コードを、USのように指定します（デフォルトはUS）。リクエストURLの生成時に値は大文字に変換されます。keywordに完全なURLを指定した場合は、そのURLに含まれるパラメータが優先され、この国の設定は適用されません。
status任意- 広告ページのステータスで絞り込みます。指定できる値はall（デフォルト）、active（配信中）、inactive（停止済み）です。これは広告の配信ステータスを表し、広告の審査ステータスではありません。keywordが広告ライブラリのURLの場合、URLに含まれるactive_statusがこのパラメータと異なることがあるため、両者を一致させてください。
Facebookのgroup_postsのパラメータはそれぞれどういう意味ですか？
グループのurlまたは識別子から、Facebookグループの投稿を取得します。本文、投稿者、投稿日時、いいね数・コメント数・シェア数を取得できます。sortで人気の投稿または最近アクティビティがあった投稿を選べます。「最近のアクティビティ」は投稿の作成日時ではなく、アクティビティの発生日時に基づきます。すべての投稿を網羅できるとは限りません。
url必須- リクエストするアクションに対応する対象URLを指定します。profileとuser_postsには公開ページのURL、postとcommentsには投稿のURL、group_postsにはグループページのURLまたはグループID、reviewsにはビジネスページのURLを指定します（reviewsでは末尾に/reviewsが付加されます）。任意のFacebook URLをアクション間で使い回すことはできません。Meta公式：グループを公開に変更しても、非公開期間のコンテンツは保護されたまま — Metaの公式ドキュメントによると、非公開グループを公開に切り替えると新しいコンテンツは公開されますが、非公開期間のコンテンツとメンバーリストは引き続き制限されます。そのため、現在公開されているグループであっても、過去の投稿や完全なメンバーリストにアクセスできるとは限りません。 · 確認日Meta公式ドキュメント：自動データ収集には事前の許可が必要 — Metaは、公開されているデータであっても、事前の許可なくFacebookのデータを自動収集することは規約違反であると明記しています。信頼できる情報源を引用しても、本プラットフォームによるデータの収集や再利用が許可されていることの証明にはなりません。 · 確認日
sort任意- group_postsの投稿の並び順を指定します。topはトップ投稿、recentは最近アクティビティがあった投稿の順で、省略した場合は時系列順になります。recentは投稿の作成日時のみではなく、アクティビティに基づきます。サポートされていない文字列を指定した場合、エラーにはならず時系列順になります。
Facebookのmarketplaceのパラメータはそれぞれどういう意味ですか？
1つの都市を対象に、商品のkeywordでFacebook Marketplaceの出品を閲覧します。価格、通貨、市区町村、州、状態、画像、投稿日時を取得できます。locationには番地ではなく、nyc（デフォルト）のような都市パスを指定します。在庫状況は確認されません。
keyword必須- プラットフォームの各エンドポイントで使用する検索クエリを指定します。searchでは公開投稿を検索し、adsでは広告のキーワード、または広告ライブラリやページのURLを直接指定できます。marketplaceでは商品の検索語、またはMarketplaceの検索URL全体を指定できます。各アクションは異なるデータセットを検索するため、同じ結果がフィールド名だけ変えて返されるわけではありません。
location任意- marketplaceで使用する都市のパス識別子を、nycのように指定します（デフォルトはnyc）。自由形式の住所は指定できません。keywordにMarketplaceのURL全体が含まれている場合はそのURLが優先され、locationは無視されます。Meta公式：Marketplaceの出品と位置情報検索の範囲 — Metaの過去のドキュメントでは、Marketplaceを地域の商品の出品・検索のための機能と定義し、商品名、価格、所在地を区別しています。これはそれらのオブジェクトを説明するものにすぎず、ネイティブUIの絞り込みオプションや過去の地域別の提供状況が、このエンドポイントの現在の機能であることを示すものではありません。 · 確認日
Facebookのreviewsのパラメータはそれぞれどういう意味ですか？
Facebookページのurlから、おすすめとレビューを収集します。本文、おすすめするかどうか、評価（ある場合）、投稿者、投稿日時を取得できます。Facebookでは星評価の代わりに「おすすめする」「おすすめしない」を使用するため、星評価がなくてもおすすめが無効になるわけではありません。
url必須- リクエストするアクションに対応する対象URLを指定します。profileとuser_postsには公開ページのURL、postとcommentsには投稿のURL、group_postsにはグループページのURLまたはグループID、reviewsにはビジネスページのURLを指定します（reviewsでは末尾に/reviewsが付加されます）。任意のFacebook URLをアクション間で使い回すことはできません。Facebook公式ドキュメント：ページのおすすめとレビュー — 公式ドキュメントでは、おすすめはページのレビューセクションに表示され、規約に違反するレビューを削除するとページの評価が変わる場合があると説明しています。ページ全体の評価と個々のおすすめは別物であるため、`is_recommended`を星評価に自動で変換することはできません。 · 確認日Meta公式ドキュメント：自動データ収集には事前の許可が必要 — Metaは、公開されているデータであっても、事前の許可なくFacebookのデータを自動収集することは規約違反であると明記しています。信頼できる情報源を引用しても、本プラットフォームによるデータの収集や再利用が許可されていることの証明にはなりません。 · 確認日
Facebookのadvertiser_searchのパラメータはそれぞれどういう意味ですか？
広告ライブラリで、ブランド名または広告主名で広告を出稿しているFacebookページを、1回の呼び出しで最大15件検索します。各ページにはID、名前、ユーザー名、カテゴリ、認証フラグ、ページのいいね数、リンクされたInstagramアカウントとそのフォロワー数が含まれます。nikeで検索すると、Nike（ページID 15087023444）が最初に表示されます。ページングはありません。
完全なAPIリファレンス：パラメータ、コードサンプル、レスポンス例、稼働状況keyword必須- ブランド名または広告主名です（例：
nike）。広告ライブラリでその名前で広告を出稿しているページを返します。各idはページIDです。
Facebookのad_detailのパラメータはそれぞれどういう意味ですか？
リンクまたは広告ライブラリIDから、Facebook広告ライブラリの広告を1件開きます。配信中かどうか、開始日と終了日、広告テキスト、見出し、リンクとCTA、表示形式、配信された掲載面、画像または動画、すべてのクリエイティブバリエーション、広告主のページID・名前・いいね数・カテゴリを取得できます。費用、リーチ、ターゲティングは結果に含まれません。
完全なAPIリファレンス：パラメータ、コードサンプル、レスポンス例、稼働状況url必須- 対象の広告1件を、広告ライブラリのリンク（https://www.facebook.com/ads/library/?id=<Library ID>）または数値のライブラリID（
adsの行のid）で指定します。
Facebookのevents_searchのパラメータはそれぞれどういう意味ですか？
music festivalのようなkeywordで公開Facebookイベントを検索します。各イベントには名前、開始日時、Facebookに表示される日付、会場、オンラインフラグ、開催済みかどうか、参加予定数と興味ありの数、表示されている場合はチケット価格のテキスト、カバー画像が含まれます。過去のイベントも含まれます。1ページあたり約5件で、続きはnext_page_tokenで取得します。
keyword必須- 公開イベントを検索するキーワードです（例：
music festival、yoga Singapore）。過去のイベントも含まれるため、is_pastを確認してください。 page_token任意events_searchとpage_eventsで使うページトークンです。最初のページでは指定せず、以降のページでは前回のレスポンスのnext_page_tokenを受け取ったとおりそのまま渡してください。最後のページには含まれません。
Facebookのmarketplace_itemのパラメータはそれぞれどういう意味ですか？
Facebook Marketplaceの出品1件を、リンクまたは数値IDから取得します。タイトル、説明、価格と元の価格、通貨、状態、商品属性、座標付きの所在地、出品日時、売約済み・取引中フラグ、配送・受け渡しオプション、写真、出品者の名前・評価・評価数・登録日を取得できます。
完全なAPIリファレンス：パラメータ、コードサンプル、レスポンス例、稼働状況url必須- 対象の出品1件を、Marketplaceの商品リンク（https://www.facebook.com/marketplace/item/<ID>/）または数値の商品ID（
marketplaceの行のid）で指定します。
Facebookのpage_eventsのパラメータはそれぞれどういう意味ですか？
公開Facebookページのリンクから、そのページが主催する今後および過去のイベントを一覧表示します。各イベントには名前、開始日時、会場、都市、主催者、およびオンライン・開催済み・キャンセルのフラグが含まれます。1ページあたり最大10件で件数は変動し、続きはnext_page_tokenで取得します。イベントを主催していないページの場合は空のリストが返ります。
url必須- 公開ページのリンクです（例：https://www.facebook.com/brickyardoldtown）。/p/<name>-<ID> 形式のリンクも使用できます。
page_token任意events_searchとpage_eventsで使うページトークンです。最初のページでは指定せず、以降のページでは前回のレスポンスのnext_page_tokenを受け取ったとおりそのまま渡してください。最後のページには含まれません。
Facebookのpost_transcriptのパラメータはそれぞれどういう意味ですか？
公開Facebook動画、リール、動画投稿の音声を、リンクからテキストに変換します。文字起こしと動画の長さ（秒）を取得できます。誰も話していない動画ではtextは返されません。
url必須- 公開されている動画、リール、または動画投稿のリンクです（例：https://www.facebook.com/reel/<ID>/）。
Facebook APIの使い方
- 01公開カタログからプラットフォームのアクションを選択します。
- 02プラットフォーム、アクション、必須パラメータをPOST /api/v1/socialに送信します。
- 03レスポンスから結果を読み取ります。非同期のアクションの場合は、返されたジョブIDをポーリングします。
- 04アプリケーションで必要なレスポンスフィールドを保存します。
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"facebook","action":"search","params":{"keyword":"<keyword>"}}'
Facebookのガイド
これらのアクションを使った実践例と手法です。まずこのページで現在のアクション、パラメータ、フィールドを確認してください。記事内の例や制限は、最新のカタログに代わるものではありません。
マルチプラットフォームの評判モニタリング設計：ネガティブな変化を評価する前に範囲を決める
監視対象リスト、コメントの識別子、増分カーソルを起点に、追跡可能な評判モニタリングのワークフローを設計します。オフラインのサンプルで重複排除と取り込み漏れを示しつつ、人によるレビューを維持します。
記事を読む統合データAPI入門：機能カタログから最初の有効な結果を得るまで
platform、action、paramsで複数プラットフォームのデータにアクセスします。機能カタログの読み方、最小限のリクエストの送信、非同期タスク・部分的な結果・課金の扱い方、追跡可能なデータ記録の作り方を解説します。
記事を読むFacebook APIに関する質問
Facebook APIでは何を取得できますか？
platformをfacebookに設定します。現在のカタログには検索、詳細、ユーザーの投稿、投稿詳細、コメント、moreが掲載されています。これらのアクション名はそれぞれ異なるFacebookのオブジェクトやビューを表すもので、互いに置き換えられる検索モードではありません。
Facebookに公式APIはありますか？
はい。MetaのGraph APIが公式のインターフェースです。自分のアプリで管理していないFacebookページの公開投稿やコメントを読み取るには、Page Public Content Access機能が必要です。この機能は、App Reviewとビジネス認証を経た場合にのみMetaから付与されます。個人のタイムラインは、本人の許可がある場合に限り、限られた用途でのみ利用できます。
公式情報源： Meta：Page Public Content Access · Meta Graph API · 確認日
Facebookの開発者アカウントやAPIキーは必要ですか？
いいえ、不要です。リクエストはEveryInfraのAPIキーを使ってEveryInfra経由で送信します。新規登録後、コンソールでキーを作成し、Authorization: Bearer <API_KEY>として送信してください。Facebookの開発者アプリの登録、Facebook APIへのアクセス申請、Facebookアカウントでのログインは必要ありません。また、アクションが返すのはFacebookの公開データのみです。
Facebook APIの料金は1,000リクエストあたりいくらですか？
アクションに応じて1,000リクエストあたり$0.88から、各アクションの料金は、このページの表と公開カタログに記載されています。サブスクリプションはなく、USD残高をチャージして呼び出しごとに料金を支払います。失敗した呼び出しや結果が空の場合は課金されません。
Facebookのsearchリクエストを開始するには、どの入力を使用しますか？
プラットフォームの各エンドポイントで使用する検索クエリを指定します。searchでは公開投稿を検索し、adsでは広告のキーワード、または広告ライブラリやページのURLを直接指定できます。marketplaceでは商品の検索語、またはMarketplaceの検索URL全体を指定できます。各アクションは異なるデータセットを検索するため、同じ結果がフィールド名だけ変えて返されるわけではありません。params内のkeywordとして送信してください。
Facebookのsearchはどのフィールドを返しますか？
宣言されたスキーマにはtext、author_name、author_username、author_idが含まれます。宣言されたフィールドでも個々のレコードには含まれない場合があり、他のアクションにはそれぞれ独自のフィールド一覧があります。
Facebookのアクションはすべて即座に結果を返しますか？
非同期と表示されたアクションはジョブIDを返すので、そのIDをポーリングします。それ以外のすべてのアクションも非同期で実行できます。リクエストボディに"mode": "async"を追加するとすぐにジョブIDが返されるため、時間のかかるタスクや上限値を大きく設定する場合に便利です。現在のカタログにはsync配信とasync配信が含まれています。