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

Instagram のキャプション上限:文字数、ハッシュタグ、@タグ(API)

Instagram API では、写真、リール、カルーセルの投稿に最大 2,200 文字のキャプションを付けられ、@タグは最大 20 件です。2026 年 11 月時点で、Instagram のヘルプセンターでは投稿あたりのハッシュタグは 5 個までとされていますが、Meta の API リファレンスには今も 30 と記載されているため、5 個以内に抑えてください。@メンションされたアカウントには投稿の公開時に通知が届きます。キャプションが長すぎる場合は、コード 36004、サブコード 2207010 のエラーで失敗します。

easyCoexistence では、publish_instagram_post を使って、Claude、ChatGPT、または独自のコードから、写真、カルーセル、リールをキャプション付きで公開できます。

2,200

API で送信できるキャプションの最大文字数。

5

Instagram ヘルプセンターが現在許可する、投稿あたりのハッシュタグの最大数(キャプションとコメントを合わせて)。

30

Meta の API リファレンスに記載された、キャプションあたりのハッシュタグの最大数。古い数値のままです。

20

1 件のキャプションに付けられる @タグの最大数。超えるとコード 100、サブコード 2207040 が返されます。

2207010

Instagram の上限を超えるキャプションの場合に、コード 36004 の下で返されるサブコード。

Partial

media_publish は config_issue の CAPTION_NOT_ATTACHED で成功する場合があり、その投稿はキャプションなしで公開されています。

キャプションの上限はいくつですか?

3 つあり、いずれもメディアコンテナの caption パラメータに適用されます。キャプションには #tag 形式のハッシュタグや、@username 形式の Instagram アカウント名を含められ、以下の上限内で指定します:

  • 長さ:最大 2,200 文字。
  • ハッシュタグ:Instagram のヘルプセンターによると、コメント内のものも含めて投稿あたり最大 5 個です。Meta の API リファレンスでは今も 30 個とされています。
  • @タグ:最大 20 件。各メンションされたアカウントには、投稿の公開時に通知が届きます。

どの投稿にキャプションを付けられますか?

写真、リール、カルーセルです。カルーセルでは、内部の画像や動画がキャプションに対応していないため、キャプションはカルーセルのコンテナに付けます。Meta のリファレンスではストーリーズのキャプションについて記載がないため、ストーリーズに入れたい文字はストーリーズの画像または動画そのものに含めてください。

キャプションが上限を超えるとどうなりますか?

リクエストは問題を示すエラーで失敗します。キャプションが長すぎる場合は、コード 36004、サブコード 2207010 が返され、Meta の対処案には上限が改めて記載されています:最大 2,200 文字、30 個のハッシュタグ、20 件の @タグです。@タグが 20 件を超えると、コード 100、サブコード 2207040 が返されることもあります。キャプションを短くして、リクエストを再送してください。

メンションされたアカウントへの通知はいつ届きますか?

コンテナを作成したときではなく、公開されたときです。キャプションで @メンションされたアカウントには、その時点で通知が届くため、事前に準備したコンテナは公開されるまで誰にも通知しません。キャプションあたり 20 件の @タグという Meta の上限は、このメンションにも適用されます。

キャプションなしで投稿が公開されることはありますか?

はい。media_publish は config_issue フィールドに CAPTION_NOT_ATTACHED が設定された状態で成功する場合があり、これはメディアがキャプションなしで公開されたことを意味します。Meta はこれを部分的な成功と呼んでいます。メディア ID は有効なので、同じ投稿を再度公開せず、投稿の状態を照合してください。

公開後にキャプションを変更できますか?

Meta のメディアリファレンスには、公開済みメディアに対する更新として、POST /<IG_MEDIA_ID> と comment_enabled を使ったコメントのオン・オフの切り替えのみが記載されています。キャプションを編集する方法は記載されていないため、コンテナを作成する前に、テキスト、ハッシュタグ、@タグを確認してください。

よくある間違い

  • 長さだけを確認すること。2,200 文字未満のキャプションでも、Instagram の現在のルールである 5 個を超えるハッシュタグや、20 件を超える @タグがあれば上限を超えます。
  • カルーセルの各項目にキャプションを付けること。キャプションを付けられるのはカルーセルのコンテナだけです。
  • ストーリーズにキャプションを書くこと。ストーリーズのコンテナはキャプションを受け付けないため、文字は画像または動画に入れてください。
  • CAPTION_NOT_ATTACHED の後に再度公開すること。最初の投稿はすでに公開されており、再公開すると重複が作られます。
EasyCoexistence で実現する

カルーセルではキャプションを一度だけ設定し、list_social_posts で各投稿のキャプションを読み戻せます。接続 1 件あたり月額 US$ 9 から、接続を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料トライアルです。

よくある質問

Instagram のエラー 2207040 とはどういう意味ですか?

キャプションに @タグが 20 件を超えて含まれており、コード 100 で返されています。20 件以下になるまでタグを減らして、リクエストを再送してください。

Instagram の 5 個のハッシュタグ上限には、コメントのハッシュタグも含まれますか?

はい。Instagram ヘルプセンターでは、投稿には最大 5 個のハッシュタグを付けられ、キャプションとコメントのものを合わせて数えます。

公開済みの投稿のコメントを API でオフにできますか?

はい。POST /<IG_MEDIA_ID> で comment_enabled を false に設定するとコメントがオフになり、true に設定すると再びオンになります。これは、Meta のメディアリファレンスに記載された、公開済みメディアに対する唯一の更新です。

エラー 2207010 とはどういう意味ですか?

キャプションが Instagram の上限より長いことを意味します。2,200 文字以下に短くして、リクエストを再送してください。

続きを読む

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

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

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

確認日