APIでInstagramストーリーズを公開する
Instagram APIは、公開URLにある1つの画像または1つの動画からストーリーズを公開します。media_type に STORIES を指定してコンテナを作成し、そのあと公開します。画像はJPEG形式で8 MBまで、動画は3〜60秒で100 MBまでです。Metaは9:16のフレームを推奨しており、ストーリーズはアプリと同じく24時間で消えます。
easyCoexistence は、Claude、ChatGPT、または独自のコードから publish_instagram_post を使って画像と動画のストーリーズを公開でき、独自のキューからスケジュールすることもできます。
APIで公開できるストーリーズ動画の最長。最短は3秒で、ファイルは最大100 MBまでです。
APIで公開できる最大のストーリーズ画像。JPEG形式である必要があります。
公開したストーリーズが期限切れになるまでの表示時間。
この値を下回るストーリーズ指標は、数値の代わりにエラーコード 10(視聴者数が不足)が返されます。
ストーリーズはどのように公開しますか?
ほかの投稿と同じ2つの呼び出しで公開します。POST /<IG_ID>/media で media_type に STORIES を指定し、image_url または video_url のどちらかを設定します。次に POST /<IG_ID>/media_publish にコンテナIDを渡します。動画のストーリーズは先に処理されるため、公開する前にコンテナの status_code が FINISHED になっている必要があります。
Metaのリファレンスでは、写真・動画・カルーセルのキャプションは説明されていますが、ストーリーズのキャプションについては記載がありません。そのため、視聴者に伝えたい言葉は画像または動画そのものに入れてください。
ストーリーズのメディア要件は?
Metaは、トリミングや余白を避けるため、ストーリーズの画像と動画のどちらにも9:16のフレームを推奨しています。
- 画像:JPEG形式、8 MBまで、sRGB。ほかの色空間は変換されます。
- 動画:MOVまたはMP4。映像はH.264またはHEVC、音声はAAC。毎秒23〜60フレーム、横幅は最大1920ピクセル、25 Mbpsまで。
- 動画の長さ:3〜60秒。ファイルは最大100 MBまで。
- 動画のアスペクト比:0.1:1から10:1までの範囲を受け付けます。
ストーリーズには何を載せられますか?
画像または動画そのものと、ほかのアカウントへのメンションです。2025年7月以降、user_tags パラメータで画像と動画のストーリーズ内の公開アカウントをタグ付けできます。x と y の座標は任意です。APIを通じたステッカーの公開にはMetaが対応していないため、リンク、投票、位置情報はアプリで設定してください。
公開後のストーリーズはどうなりますか?
アプリと同じく24時間表示され、そのあと期限切れになります。Metaは公開中のストーリーズを、別の stories エッジに表示します。アカウントのメディア一覧 GET /<IG_ID>/media には含まれません。取得したストーリーズの media_type は、ほかのメディアと同じく IMAGE または VIDEO です。そのため、ストーリーズは種類ではなく、取得元で見分けてください。
返信やメンションはどのように届きますか?
ダイレクトメッセージ(DM)として届きます。ストーリーズへの返信は、ストーリーズのIDとURLを添えて messages Webhook に届き、通常の24時間ウィンドウが開きます。誰かが自分のストーリーズでアカウントをメンションすると、story_mention 型の添付ファイルを含むメッセージとして届きます。MetaのMentions APIはストーリーズを対象としていません。
ストーリーズではどの指標が取得できますか?
リーチ、視聴数、シェア、返信、フォロー、プロフィールへのアクセス、プロフィールのアクティビティ、ナビゲーション、リンクのクリック、リポスト、インタラクション合計です。メディアインサイトのエンドポイントから取得します。指標は24時間のみ利用でき、値が5未満の場合は数値の代わりにエラーコード 10 が返されます。欧州または日本からの返信は集計から除外され、欧州または日本のアカウントが作成したストーリーズは、返信数が0と報告されます。
よくある間違い
- リンクステッカーを計画すること。APIはステッカーを公開しないため、リンクは別の方法で届ける必要があります。たとえばDMへの返信などです。
- 翌日にストーリーズの指標を読むこと。指標は24時間しか利用できないため、ストーリーズが表示されているうちに収集してください。
- 公開したストーリーズをアカウントのメディア一覧で探すこと。公開中のストーリーズは別の stories エッジに表示されます。
- 横向きの動画をストーリーズとして公開すること。Metaは9:16を推奨しており、ほかの形状では余白が出るか、トリミングされることがあります。
ストーリーズへの返信はDMとして届き、お使いのエンドポイントへ転送するか、オートメーションで自動返信できます。接続 1 件あたり月額 US$ 9 から、接続を増やすほど下がって US$ 0.75 まで。最初の 3 日間は無料トライアルです。
よくある質問
APIでストーリーズにリンクステッカーを追加できますか?
いいえ。Metaは、リンク、投票、位置情報を含め、APIを通じたステッカーの公開に対応していません。ほかのアカウントをステッカーなしでメンションすることは対応しています。
APIで公開したストーリーズは、どこに表示されますか?
公開中は、アカウントの別の stories エッジに表示されます。GET /<IG_ID>/media にはストーリーズは含まれず、取得したストーリーズは IMAGE または VIDEO として返されます。
APIでストーリーズにキャプションを付けられますか?
いいえ。Meta のリファレンスには、ストーリーズのキャプションについての記載はありません。publish_instagram_post もキャプションなしでストーリーズを送信するため、視聴者に伝えたい言葉は画像または動画そのものに入れてください。
ストーリーズのインサイトはどのくらい利用できますか?
24時間です。Metaはストーリーズの指標をこの期間のみ提供するため、ストーリーズが表示されているうちに読み取ってください。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日