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

Instagram API のエラー:主要なエラーコードの意味

Instagram API で最もよく見られるエラーは、期限切れまたは無効なトークンを示す 190、レート制限の 4、17、80002、Meta が取得できないメディアの 9004、処理中の動画の 9007、1 日の投稿上限の 9、メッセージ送信期間の外にある DM の 10(サブコード 2534022)です。各エラーは JSON で返され、カテゴリを示すコードと、多くの場合は具体的なケースを示すサブコード、そしてメッセージを含みます。

easyCoexistence は、これらのエラーの接続側を担当します。

190

期限切れ、取り消し済み、またはその他の理由で無効になったアクセストークンを示す Graph API コードです。

80002

Instagram のビジネス利用ケースのレート制限を示すエラーコードです。

2207042

アカウントが 1 日の API 投稿上限に達したことを示す、コード 9 のサブコードです。

2207052

Meta が指定された URL からメディアを取得できなかったことを示す、コード 9004 のサブコードです。

2534041

アカウントが Instagram のメッセージへのアクセスをオフにしている場合の、コード 200 のサブコードです。

Instagram API のエラーはどう読めばよいですか?

すべてのエラーは error 内の JSON オブジェクトです。code は大まかなカテゴリ、error_subcode は具体的なケースを示し、通常はこちらの方が役立ちます。message はエラーの内容を説明します。多くのエラーには、利用者向けのテキストである error_user_title と error_user_msg、そして is_transient も含まれます。fbtrace_id はリクエストを Meta サポートに示す識別子で、すぐに失効するため、エラー発生時にログへ記録してください。

アクセスと権限のエラーはどのような意味ですか?

誰が何をできるかに関するエラーです。それぞれの修正方法は次のとおりです:

  • 190:アクセストークンが期限切れ、取り消し済み、またはその他の理由で無効です。サブコード 463 は期限切れ、467 は無効、460 はパスワード変更を意味します。新しいトークンを取得すれば解決します。接続済みのアカウントの場合は、再接続が必要です。
  • 10:権限が拒否されました。権限が付与されていないか、後から削除されています。
  • 200 から 299:特定の権限が不足しています。例えば、アカウントがメッセージへのアクセスをオフにしている場合は、200 とサブコード 2534041 になります。
  • 25、サブコード 2207050:アカウントが制限・非アクティブ化されているか、チェックポイントで止められています。オーナーが Instagram アプリにサインインし、求められた内容を完了する必要があります。

レート制限のエラーはどのような意味ですか?

スロットリングです。いずれも一時的なものです:

  • 4:アプリからの呼び出しが多すぎます。待ってから再試行するか、リクエストの量を減らしてください。
  • 17:ユーザーに対する呼び出しが多すぎます。対処法は同じです。
  • 80002:Instagram のビジネス利用ケースの制限です。アプリとアカウントごとに、アカウントのインプレッションに基づいて算出されます。24 時間で、インプレッションあたり 4,800 回の呼び出しです。
  • 613、サブコード 2534040:メッセージング関連の呼び出しが多すぎます。一時停止して、後で再試行してください。

メディアに関する投稿エラーはどのような意味ですか?

ファイルとそのホスティング先に関するエラーです。現状のまま再試行する価値があるのはタイムアウトだけです:

  • 9004、サブコード 2207052:Meta が URL からメディアを取得できませんでした。URL が有効で公開されていることを確認してください。
  • -2、サブコード 2207003:ダウンロードに時間がかかりすぎました。これは再試行する価値があります。
  • 36000、サブコード 2207004:画像が 8 MB を超えています。
  • 36001、サブコード 2207005:画像形式がサポートされていません。JPEG を使用してください。
  • 36003、サブコード 2207009:アスペクト比が 4:5 から 1.91:1 の範囲外です。
  • 352、サブコード 2207026:動画形式がサポートされていません。MOV または MP4 を使用してください。

投稿のタイミングと上限に関するエラーはどのような意味ですか?

いつ、どれだけかに関するエラーです。多くは待つか、やり直すことで解決します:

  • 9007、サブコード 2207027:メディアの準備ができていません。コンテナの status_code が FINISHED と表示されるまで待ってください。
  • 24、サブコード 2207008:コンテナが存在しないか、期限切れです。30 秒から 2 分の間に 1 回か 2 回再試行し、それでもだめなら新しく作成してください。
  • -2、サブコード 2207020:メディアが期限切れです。新しいコンテナを作成してください。
  • 9、サブコード 2207042:アカウントが 1 日の投稿上限に達しました。翌日に再試行してください。
  • 100、サブコード 2207028:カルーセルには 2 から 10 個のアイテムが必要です。
  • 36004、サブコード 2207010:キャプションが長すぎます。Meta の上限は 2,200 文字と @ タグ 20 個で、リファレンスではハッシュタグは 30 個とされていますが、Instagram では投稿につき 5 個まで許可されています。
  • 4、サブコード 2207051:スパムの疑いがあるとして、Instagram がこの操作を制限しました。

メッセージ関連のエラーはどのような意味ですか?

DM とプライベートリプライに関するエラーです:

  • 10、サブコード 2534022:許可された期間の外にメッセージが送信されました。相手が再度メッセージを送ってくるのを待ってください。
  • 100、サブコード 2534014:一致する Instagram ユーザーがいません。Webhook から得た Instagram スコープ ID を使用し、Instagram ユーザー ID は使わないでください。
  • 100、サブコード 2534025:そのコメントにはプライベートリプライを送信できません。
  • 100、サブコード 2534037:別のアプリ(Meta 自身の Business AI を含む)が会話を管理しています。
  • 551、サブコード 1545041:相手が現在利用できない状態です。

インサイトのエラーはどのような意味ですか?

インサイトのリクエストは、文書化された 3 つの方法で失敗します:

  • 10、視聴者が少なくてメディアのインサイトを表示できません。ストーリーの指標が 5 未満の場合です。
  • 2025 年 4 月 21 日以降のインプレッションのように、廃止された指標はエラーを返します。代わりに views をリクエストしてください。
  • リクエストした複数の指標のうち 1 つが、要求された内訳に対応していない場合、不明なエラーが返されます。

再試行する価値があるエラーはどれですか?

一時的なものだけです。コード 1 と 2、Instagram のサーバーエラー 2207001 と 2207032、ダウンロードのタイムアウト 2207003、短時間で解消される 2207008、そして待機時間が過ぎたレート制限です。それ以外は、ファイル、URL、権限、アカウントの状態、または相手との送信可能期間が変わるまで同じ結果を返すため、再試行してもレート制限を消費するだけです。

よくある間違い

  • 形式やサイズのエラーを再試行すること。2207004、2207005、2207009、2207026 は、メディアが変わるまで同じように失敗します。
  • 9007 を失敗として扱うこと。動画はまだ処理中です。コンテナが FINISHED と表示されたら投稿してください。
  • コードだけを読むこと。10 や 100 のようなコードは多くのケースを含み、どのケースかを示すのはサブコードです。
  • ログから fbtrace_id を省くこと。Meta サポートがこれを求め、エラーの直後にすぐ失効します。
EasyCoexistence で実現する

Instagram のアクセスは期限切れ前に更新し、6 時間ごとにアカウントを確認し、再接続が必要になるとメールでお知らせします。Claude、ChatGPT、または独自のコードは、常に最新に保たれたトークンを使って Meta の公式 API を呼び出します。接続ごとに月額 US$ 9 から US$ 0.75 まで、接続を増やすほど下がります。最初の 3 日間は無料トライアルです。

よくある質問

Instagram のエラー 190 はどのような意味ですか?

アクセストークンが期限切れ、取り消し済み、またはその他の理由で無効になっています。例えばパスワードを変更した後などです。新しいトークンを取得すれば解決し、接続済みのアカウントの場合は再接続が必要です。

9004 で投稿が失敗するのはなぜですか?

Meta が指定された URL からメディアを取得できなかったためで、サブコードは 2207052 です。投稿時点で、リンクが有効で公開されており、前にログインが必要な画面がないか確認してください。

エラー 9007 とは何ですか?

コンテナ内の動画がまだ処理中であることを示し、サブコードは 2207027 です。コンテナの status_code を確認し、FINISHED と表示されたら投稿してください。

Instagram API エラーの fbtrace_id とは何ですか?

失敗したリクエストを識別する ID で、問題を報告する際に Meta サポートが求めます。エラーの直後にすぐ失効するため、発生時点でログに書き留めてください。

続きを読む

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

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

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

確認日