oEmbed で Instagram の投稿をウェブサイトに埋め込む
Meta の Instagram oEmbed エンドポイント GET /instagram_oembed?url=<POST_URL> は、公開された Instagram の投稿やリールをウェブページに埋め込む HTML を返します。レスポンスには version、provider_name、provider_url、type、width も含まれます。2026 年 5 月 15 日以降はアクセストークンなしで呼び出せ、埋め込まれた HTML は embed.js を読み込んで投稿を表示します。
easyCoexistence は、接続済みの各 Instagram 投稿のパーマリンクを list_social_posts で返すので、oEmbed にそのまま渡せます。
この日付以降、Meta の Instagram oEmbed API は、すべてのバージョンでアクセストークンなしで呼び出せます。
Meta の oEmbed ガイドで許可されている 1 時間あたりのリクエスト数。
maxwidth が受け付ける範囲。maxheight はサポートされていません。
author_name、author_url、サムネイル関連フィールドが、すべての API バージョンの Instagram oEmbed レスポンスから削除された日。
oEmbed エンドポイントでは対象外で、非公開、非アクティブ、年齢制限のあるアカウントの投稿も含まれません。
Instagram の oEmbed エンドポイントはどのように動作しますか?
公開投稿の URL を送信すると、それを表示する HTML が返されます。このエンドポイントは、Facebook Login の呼び出しに使われる Meta のメイン Graph API ホストで動作し、graph.instagram.com ではありません。レスポンスは小さな JSON オブジェクトで、その html フィールドの内容をそのままページに配置します。
GET /instagram_oembed?url=https://www.instagram.com/p/<SHORTCODE>/
{
"version": "1.0",
"provider_name": "Instagram",
"provider_url": "https://www.instagram.com/",
"type": "rich",
"width": 658,
"html": "<EMBED_HTML>"
}どの URL を受け付けますか?
Meta のガイドで url パラメータに挙げられている 3 つの形式です。プレーンでも URL エンコードでも送信できます。ガイドの 2 つのサンプルリクエストでは、それぞれ 1 つずつ示されています:
- 単一画像・カルーセルの投稿:https://www.instagram.com/p/{media-shortcode}/
- 動画とリール:https://www.instagram.com/reel/{media-shortcode}/
- プロフィール:https://www.instagram.com/{username}
アクセストークンは必要ですか?
2026 年 5 月 15 日以降は不要です。Meta の変更履歴によると、この日から Instagram oEmbed API はトークンなしで呼び出せるようになりました。それ以前は、アプリが App Review を通じて Meta oEmbed Read 機能の承認を得たうえで、呼び出しごとにトークンを必要としていました。トークンを使う方式も引き続き利用できます。Meta の oEmbed ガイドでは 1 時間あたり最大 1,000 件のリクエストが許可されており、トークンなしのアクセスに関する Meta の発表では、トークンを使うアプリにはより高いレート制限が適用される場合があるとされています。
どのパラメータを受け付けますか?
url 以外に 4 つあります。Meta のガイドとリファレンスより:
- maxwidth:320 から 658 まで。埋め込みは他の点ではレスポンシブで、maxheight はサポートされていません。
- hidecaption:true で投稿のキャプションを非表示にします。デフォルトは false です。
- omitscript:true にすると、HTML からスクリプトを除外します。ページ側で embed.js を一度だけ読み込み、instgrm.Embeds.process() を呼び出す場合に使います。
- fields:指定したフィールドだけにレスポンスを絞り込みます。
レスポンスには何が含まれますか?
デフォルトのフィールドは 6 つです。html は表示するマークアップ、version は常に 1.0、provider_name と provider_url は Instagram を示す値、type は oEmbed のリソースタイプ、width はピクセル単位の幅です。Meta は 2025 年 11 月 3 日、すべての API バージョンで Instagram 投稿のレスポンスから author_name、author_url、thumbnail_url、thumbnail_width、thumbnail_height を削除しました。自分のアカウントの投稿の場合は、media エッジから引き続き username、permalink、thumbnail_url が返されます。
埋め込めないものは何ですか?
Meta のガイドでは、エンドポイントが対象外とするものと、その利用に関する 1 つのルールが挙げられています:
- 非公開、非アクティブ、年齢制限のあるアカウントの投稿。
- 埋め込みを無効にしているアカウント。
- ストーリーズ、および Shadow DOM 内で埋め込みを描画するページ。
- フロントエンドでの表示を超える利用は不可です。Meta は、エンドポイントのメタデータやコンテンツを他の目的で使用することを厳しく禁止しています。
自分のアカウントの投稿を埋め込むにはどうすればよいですか?
各投稿のパーマリンクを取得し、url として渡します。EasyCoexistence を通じて、list_social_posts で接続済みアカウントの最近の投稿とパーマリンクを取得できます。Claude、ChatGPT、または自社のコードから呼び出せます。oEmbed の呼び出しにはトークンが不要なので、サイトから直接呼び出せます。
よくある間違い
- ストーリーズのリンクを送信すること。Meta の oEmbed エンドポイントはストーリーズをサポートしていないため、投稿またはリールを埋め込んでください。
- レスポンスから thumbnail_url を読み取ること。Meta は 2025 年 11 月 3 日に、author_name などほかのサムネイル関連フィールドとともにこれを削除しました。
- maxwidth を 320 未満または 658 を超える値に設定すること。Meta が受け付けるのはその範囲の値だけで、maxheight は一切使用できません。
- 埋め込みごとに embed.js を読み込むこと。omitscript を true に設定した場合は、スクリプトを一度だけ読み込み、instgrm.Embeds.process() を呼び出してください。
Claude、ChatGPT、または自社のコードから、Meta の公式 API を通じてアカウントへの投稿、予約、コメントや DM への返信を行えます。接続済みの番号 1 件あたり月額 US$ 9 から、番号を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料です。
よくある質問
Instagram のリールを埋め込めますか?
はい。リールの https://www.instagram.com/reel/{media-shortcode}/ URL を渡すと、エンドポイントが埋め込み HTML を返します。
Instagram の埋め込みはレスポンシブですか?
はい。Meta のガイドによると、埋め込みはレスポンシブで、maxwidth が最大幅を設定します。
Instagram のプロフィールを埋め込めますか?
はい。Meta のガイドでは、url パラメータが受け付ける形式の中に、プロフィール URL の https://www.instagram.com/{username} が挙げられています。
oEmbed のデータを分析に使えますか?
いいえ。Meta はこのエンドポイントを、ページやアプリで投稿を表示する目的に限って許可しており、メタデータやコンテンツの他の用途は禁止しています。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日