InstagramAPIとは

Instagramのアカウントから基本的なプロフィール情報、写真、動画などの投稿情報を取得することができるもの。
2024年12月4日にInstagram Basic Display APIが終了となったため、Instagramの個人アカウントからデータを取得することができなくなりました。
APIを利用するにはプロアカウント(ビジネス・クリエイターアカウント)に切り替える必要あります。

私はInstagram情報を自社のWebアプリで表示させるため活用しましたので、その手順をまとめます。
別用途の場合は手順が異なるかもしれませんので、詳しくはMetaのHomeをご確認ください。

InstagarmAPIを始めるのに必要なステップ

1. Facebookページを作る
2. Metaアプリを作る
3. Instagramアプリを設定する
4. ビジネス認証を実施する
5. アクセス認証を実施する
6. アプリレビュー申請を実施する

※自身のInstagramカウントのみ用いるのであればNo.5,No.6は不要です
　不特定多数のInstagramアカウントで機能するアプリを作成する場合は認証やレビューが必要となります

1. Facebookページを作る

①InstagramAPIを管理するFacebookでログイン
②画面右上のアイコンから「全てのプロフィールを見る」をクリック

③新しいプロフィールまたはページを作成をクリック

④公開ページをクリック

⑤ページ名やカテゴリなど必要な情報を求められるため、記載することでFacebookページを作成できます

2. Metaアプリを作成する

①サイトにアクセス
　https://developers.facebook.com/
②利用を開始するをクリック
③Facebook for Developersアカウントを作成
④メールアドレスを入力して「認証」をクリック
⑤開発者を選択して登録完了

3. Instagramアプリを設定する

基本設定

①サイトにアクセス
　https://developers.facebook.com/apps/?show_reminder=true
②アプリを作成をクリック

③必要情報を入力して次へをクリック
　アプリ名：WebページにてInstagram連携をする際に表記される名前です
　連絡先メールアドレス：Metaからアプリに対しての通知が行われる連絡先です

④ユースケースを追加
　利用用途に応じたユースケースを追加してください
　私の場合は不特定多数のInstagramアカウントの情報を取得する権限が必要だったため、その他 > Businessを選択

⑤最終チェックとビジネスポートフォリオを選択してアプリを作成をクリック
　ビジネスポートフォリオ：1.Facebookページを作る で対応したページがあるはずなのでそちらを選択してください

⑥作成したアプリを選択
　→初回作成時は自動でページ遷移します
⑦アプリの設定 > ベーシックを選択

⑧必要な設定項目を記載して変更を保存をクリック
　プライバシーポリシーのURL：プライバシーポリシーが記載されているリンクを貼ってください
カテゴリ：アプリのジャンルを選択してください
アプリアイコン(1024 x 1024)：WebページにてInstagram連携をする際に表記されるアイコンです
※アプリレビューで必須となるので漏れないように記載してください

⑨ダッシュボード > アプリに製品を追加から Instagram の設定をクリック

⑪左のリストにInstagramが追加されます

Instagramアプリ設定

①サイトにアクセス
　https://developers.facebook.com/apps/?show_reminder=true
②3. Instagramアプリを設定する で作成したアプリを選択
③Instagram > InstagramログインによるAPI設定をクリック

④1. アクセストークンを生成する項目のアカウントを追加をクリック
　instargramのログインが求められるため、テストで用いるInstagramユーザーでログインしてください
　全ての認証/レビュー系が通るまではここに設定したアカウントのみ連携できるようになります

⑤3. Instagramビジネスログインを設定するの設定するをクリック
⑥設定項目を入力
　OAuthリダイレクトURL：認証後にリダイレクトするURL

　後続記述のInstagramAPIを利用するにあたって必要なサーバ設定で触れます

4. ビジネス認証を実施する

①サイトにアクセス
　https://developers.facebook.com/apps/?show_reminder=true
②3. Instagramアプリを設定する で作成したアプリを選択
③アプリの設定 > ベーシック > ビジネス認証項目の認証を開始をクリック

④ビジネスポートフォリオを選択して認証を開始
　認証はビジネスの管理者しか実行できません
⑤国やビジネスの詳細を問われますので記載してください
　詳細は割愛します
⑥申請後、認証完了するまでやり取りを続ける
　内容によっては記載の詳細を問われる質問がアプリのアラート > 受信箱に数日以内に届きます
質問内容に沿って回答して承認を終わらせてください

5.アクセス認証を実施する

ビジネス認証と流れはほぼ同じです
①サイトにアクセス
　https://developers.facebook.com/apps/?show_reminder=true
②3. Instagramアプリを設定する で作成したアプリを選択
③アプリの設定 > ベーシック > アクセス認証項目の認証を開始をクリック
　内容はビジネス認証と似ています
　Metaとやり取りしつつ認証を完了してください

　ビジネス認証が承認されていないと進められません

6. アプリレビュー申請を実施する

前提：
手元で動きが検証できる環境が準備できていること
　→Meta社がレビューにあたり実際に触れる環境を用意する必要があります
ビジネス認証とアクセス認証と並走して申請は可能でしたので同時に進めると時短になります

①サイトにアクセス
　https://developers.facebook.com/apps/?show_reminder=true
②3. Instagramアプリを設定する で作成したアプリを選択
③Instagram > InstagramログインによるAPI設定をクリック

④4. アプリレビューを完了するからアプリレビューへ移動を押下

⑤Continue > アクセス許可のためのアドバンスアクセスをリクエストで必要な権限を選択
　ログインしたInstagramユーザーの情報(プロフィールや投稿)を用いるのであればinstagram_business_basicのみで十分です
権限の用途を確認して選択してください参照
ちなみにinstagram_business_manage_messagesが必須で入ってますが後で消せます

⑥アプリレビューへ移動をクリック
⑦アプリレビューのリクエストの編集をクリック

⑧指示に従って権限をリクエストしている理由を入力してください
⑨申請画面が開くので回答してレビューを完了する
　こちらも一度で通ることの方が少ないと思います
　アラート > 受信箱に送られてきた指摘を確認しつつ進めてください

※アプリレビューの注意事項

申請は英語で回答するのが無難です
- 筆者は下記を記載することで申請が通りました
  - そのプロダクトは何をしているものなのか
  - 申請した権限はなぜ必要なのか
  - どのようなMetaデータを扱っているのか
  - 実際にInstagramログインを行い連携を行っていかがわかる動画
レビュー者は技術者ではないようなので曖昧な表現は避けましょう
テストユーザーはこちらで準備してIDとパスワードを共有しましょう
- アカウント情報を書かないでと書いてありますが、レビュー通るまではテストユーザーしか使えないのでどうしようもありません
困ったときはダイレクトサポートを活用しましょう
- 何故レビューが棄却されたかわからないときなどのサポート先です
- 大体1日か2日後には返事をくれます
- アプリレビュー周りかデータ保護評価周り以外のことはサポート外
  - ビジネス認証やアクセス認証のことは質問してもサポート外としか言われません

InstagramAPIを利用するにあたって必要なサーバ設定

APIを実行するあたって必要なMetaアプリ情報
- InstagramアプリID
- Instagram app secret
  - どちらもInstagram > InstagramログインによるAPI設定に記載されてます
- リダイレクトURL
  - コードに合わせてアプリ側の設定を変更する
APIの使い方自体は公式から出ているのでここでは省きます
- 公式のAPI利用方法