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

API で Instagram リールを公開する

Instagram API は、公開 URL にある MOV または MP4 ファイルからリールを公開します。media_type を REELS にしてコンテナを作成し、Meta が動画を処理するまで待ってから公開します。リールは 3 秒から 15 分、最大 300 MB まで対応しています。Meta は、切り抜きや余白を避けるため 9:16 のフレームを推奨しています。

easyCoexistence は、Claude、ChatGPT、または独自のコードから publish_instagram_post を使ってリールを公開します。

15 min

API で公開できる最長のリール。最短は 3 秒です。

300 MB

リールファイルの最大サイズ。MOV または MP4 で、映像は H.264 か HEVC、音声は AAC です。

1 min

処理中のコンテナの状態を確認する、Meta が推奨する間隔。5 分を上限とします。

24 hours

公開されずにリールのコンテナが待機できる時間。期限切れまでの期間です。

リールはどのように公開されますか?

3 つのステップで行います。まず、media_type を REELS、video_url に動画ファイルの場所を指定し、必要であればキャプションを付けて POST /<IG_ID>/media を送信します。Meta が動画を取得し、コンテナ ID を返します。次に、コンテナの status_code を確認しながら、Instagram が動画を処理し終えるまで待ちます。最後に、creation_id にコンテナ ID を指定して POST /<IG_ID>/media_publish を送信すると、レスポンスに新しいメディア ID が含まれます。

Meta の再開可能アップロード(コンピューターからファイルを送信できる方式)は、Facebook Login for Business(Unified Login を含む)をもとにした設定でのみ提供されています。Instagram Login を使う場合、動画は必ず公開 URL から取得されます。

動画の要件は何ですか?

Instagram が処理する前に、ファイルが満たす必要がある Meta のリール仕様です:

  • ファイル形式:MOV または MP4(MPEG-4 Part 14)。エディットリストがなく、moov アトムはファイルの先頭にあること。
  • 動画:H.264 または HEVC、プログレッシブスキャン、クローズド GOP、4:2:0 クロマサブサンプリング、毎秒 23 から 60 フレーム、幅は最大 1920 ピクセル、最大 25 Mbps。
  • 音声:AAC、最大 48 kHz、モノラルまたはステレオ、128 kbps。
  • アスペクト比:0.01:1 から 10:1 の範囲で任意。9:16 を推奨。
  • 長さとサイズ:3 秒から 15 分、最大 300 MB。

動画の処理中には何が起きますか?

コンテナの status_code は、Instagram が動画を処理し終えるまで IN_PROGRESS と表示され、その後 FINISHED になります。公開できるのは FINISHED になってからです。それより前に公開すると、コード 9007、サブコード 2207027 で失敗します。これは修正ではなく、待つべきことを意味します。Meta は、状態の確認を 1 分ごとに、ただし 5 分を上限として行うことを推奨しています。

ERROR は、コンテナの処理が完了しなかったことを示し、EXPIRED は 24 時間公開されないまま放置されたことを示します。どちらの場合も新しいコンテナが必要です。PUBLISHED は、リールがすでに公開されていることを示します。

API でどのリールオプションを使えますか?

動画とキャプションのほかに、Meta のリールコンテナは次のパラメーターを受け付けます:

  • share_to_feed:true にするとリールをリールタブとフィードの両方に表示し、false にするとリールタブのみに表示します。どちらの値でも、リールタブへの掲載は保証されません。
  • cover_url:リールタブのカバーとして使う、最大 8 MB の JPEG。中央の 9:16 部分に切り抜かれ、フィードに共有する場合は正方形に切り抜かれます。
  • thumb_offset:カバーがない場合にサムネイルとして使うフレームの位置(ミリ秒)。0 が最初のフレームです。
  • audio_name:リールの音声の名前。一度だけ設定できます。
  • trial_params:トライアルリールを公開します。アカウントをフォローしていない人にのみ共有され、正式な公開に移行するまで続きます。

リールにはほかにどのような決まりがありますか?

リールは、コンテナが作成された時点から次のルールに従います。

  • リールをカルーセルの一部にすることはできません。常に単独で公開されます。
  • 公開時にアカウントのプライバシー設定が適用されます。リミックスを許可がオンなら、新しいリールもリミックスを許可します。
  • 音楽タグ付けは、オリジナル音声の場合のみ利用できます。
  • 後から読み取ると、リールは他の動画と同じく media_type VIDEO と表示されます。
  • アカウントの 24 時間あたり 100 件の API 公開投稿の上限に、1 件として数えられます。

リールはどの指標を報告しますか?

メディアインサイトのエンドポイントを通じて、リールは reach、views、likes、comments、saved、shares、total_interactions、reposts を報告します。さらに独自の 3 つの指標、ig_reels_avg_watch_time、ig_reels_video_view_total_time、reels_skip_rate も報告します。reels_skip_rate は、最初の 3 秒以内にスキップされた視聴の割合です。likes、comments、views はオーガニックな活動のみを数えており、その元データは最大 48 時間遅れることがあります。

よくある間違い

  • コンテナを作成した直後に公開すること。status_code が FINISHED になるまで待ってください。待たないと、サブコード 2207027 で呼び出しが失敗します。
  • WebM や AVI のファイルを送信すること。リールは MOV または MP4 である必要があり、そうでなければ Meta はコード 352、サブコード 2207026 で拒否します。
  • share_to_feed でリールがリールタブに表示されると期待すること。このパラメーターはフィードへの掲載を追加するだけで、リールタブに何を表示するかは Instagram が決めます。
  • コンテナを公開しないまま一晩放置すること。コンテナは作成から 24 時間後に期限切れになり、その後は新しいコンテナが必要です。
EasyCoexistence で実現する

動画 URL とキャプションを渡すと、動画の処理中でも自動的に公開まで完了します。リールは easyCoexistence の独自のキューからスケジュールすることもできます。接続済みの番号 1 件あたり月額 US$ 9 から、番号を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料トライアルです。

よくある質問

API でリールはどのくらいの長さにできますか?

3 秒から 15 分までで、最大 300 MB の MOV または MP4 ファイルです。

コンピューターからリールをアップロードできますか?

Instagram Login では、できません。API は公開 URL から動画を取得するので、まずファイルを公開リンクが得られる場所に置いてください。

API で公開したリールは、フィードにも表示されますか?

表示できます。share_to_feed パラメーターで、リールをリールタブに加えてフィードにも表示するかどうかを決められます。

リールの公開が 9007 で失敗するのはなぜですか?

Instagram がまだ動画を処理しているためです。status_code を確認し、FINISHED と表示されてから公開してください。リクエスト側で直す必要はありません。

続きを読む

最初のチャンネルを 2 分で接続しましょう。

プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。

  • 3 日間無料
  • いつでも解約可能
  • 公式 API のみ使用
  • 24/7 監視

確認日