Instagramアプリを作成してアカウントのAccess Tokenを取得する
このガイドでは、Meta for DevelopersでInstagramアプリを作成し、自分のInstagramプロアカウントをテスターとして追加してInstagram User Access Tokenを生成し、フォロワー数を取得できるか確認します。
個人開発、APIのデバッグ、公開前のテスト向けの手順です。アプリが開発モードの間は、管理者、開発者、招待を承認したテスターだけが利用できます。
重要：このガイドは
graph.instagram.comを使う Instagram API with Instagram Login 向けです。Facebook Pageが必要な Instagram API with Facebook Login とは別の認証方式です。
1. 事前準備
次のものを用意します。
- Meta for Developers にログインできるMeta/Facebook開発者アカウント
- BusinessまたはCreatorのInstagramプロアカウント
- そのInstagramアカウントのログイン情報
- 生成したAccess Tokenを安全に保存する場所
個人アカウントの場合は、先にBusinessまたはCreatorへ切り替えてください。Instagram API with Instagram Loginはプロアカウント向けです。
2. Metaアプリを作成する
Metaのアプリ一覧を開いてログインし、右上の Create an application / アプリを作成 を選択します。
アプリ名、連絡先メールなどを入力します。ユースケース選択画面で Managing messages and content on Instagram を選びます。
画面の案内に従って残りの設定を完了します。作成後、アプリのDashboardが開きます。
Metaは画面構成や翻訳を変更することがあります。表示名が違う場合はInstagram、Use cases、Application identityなどの語で探してください。
3. Instagramテスターを追加する
Dashboard左側の Application Identity / アプリのアイデンティティ を開き、ユーザー管理で右上の Add user / ユーザーを追加 を選択します。
ダイアログで Instagram testers を選び、認証するInstagramユーザー名を入力します。@ は付けず、該当アカウントを確認して招待を送ります。
通常のTesterではなく、ダイアログ下部に個別表示される Instagram testers ロールを選んでください。
一部の画面には古い「Instagram Basic Display API」という説明が残る場合があります。Meta側の表記が未統一なためで、このガイドは廃止済みのBasic Display APIを使用しません。
4. Instagramでテスター招待を承認する
追加したInstagramアカウントでログインし、次のページを開きます。
https://www.instagram.com/accounts/manage_access/
Instagram設定から次の順でも開けます。
Website permissions
→ Apps and websites
→ Tester InvitesTester Invites でアプリを見つけて承認します。承認後に初めて有効なテスターになります。
招待が見つからない場合は、ログイン中のユーザー名がDashboardに追加した名前と完全に一致するか確認し、再ログインしてください。
5. Instagramアカウントを追加してTokenを生成する
MetaのDashboardに戻り、Use cases / ユースケース を開きます。Instagramユースケース横の Customize / カスタマイズ を選択します。
Instagram API設定で API setup with Instagram Login を選びます。通常は次の権限が表示されます。
instagram_business_basic
instagram_business_manage_comments
instagram_business_manage_messagesアカウント情報とフォロワー数だけを確認する場合、必要な中心権限は instagram_business_basic です。コメント、メッセージ、投稿権限は必要な機能に限って申請してください。
Generate access password / Generate access token で Add account を選択し、招待を承認したInstagramアカウントでログインして認証します。
追加後、アカウント横の Generate password / Generate token を選択し、内容を確認して生成された文字列をコピーします。
画面で「Access password」と表示される場合がありますが、実体は Instagram User Access Token であり、Instagramのログインパスワードではありません。
Tokenは通常、一度だけ完全に表示されます。パスワード管理ツール、サーバーのシークレット保管庫、環境変数へ保存し、コード、画像、チャット、公開ログ、Gitには入れないでください。
6. Graph API ExplorerでTokenを検証する
Graph API Explorer を開き、次のように設定します。
- メソッドは
GET。 - APIホストは
graph.instagram.com。 - 現在サポート中のバージョン（画像では
v25.0）。 - パスは
me?fields=id,username,followers_count。 - Access Token欄にTokenを貼り付ける。
- Submit / 送信 を選択する。
同等のリクエストは次のとおりです。
GET https://graph.instagram.com/v25.0/me?fields=id,username,followers_count
Authorization: Bearer <INSTAGRAM_ACCESS_TOKEN>cURLでも実行できます。
curl -G "https://graph.instagram.com/v25.0/me" \
-H "Authorization: Bearer $INSTAGRAM_ACCESS_TOKEN" \
--data-urlencode "fields=id,username,followers_count"成功時の例：
{
"id": "<INSTAGRAM_USER_ID>",
"username": "your_username",
"followers_count": 123
}正しい id、username、followers_count が返れば、Token、アカウント認証、基本権限が有効です。
自分のプロアカウントでは複数形の followers_count を使います。Messaging User Profile APIでDMユーザーを調べる場合は単数形の follower_count です。
7. 対象範囲と制限
ここで生成するテストTokenは、主にアプリ管理者やInstagramテスター自身の開発とデバッグ用です。
現在のアプリを認証したInstagramプロアカウントだけを直接取得できます。ユーザー名だけで任意の個人アカウントを検索したり、未認証アカウントの非公開情報を取得したりはできません。
開発モードでは、アプリのロールと招待を承認したテスターだけが認証できます。顧客向けには正式なInstagram Login/OAuthを実装し、必要に応じて公開、ビジネス認証、App Reviewを完了してください。
未認証の公開Business/Creatorを調べる場合は、Instagram API with Facebook Login のBusiness Discoveryを検討します。このInstagram Login Tokenは直接利用できません。
8. よくある質問
1. アカウント追加時にInstagramユーザーが見つかりません
Instagram tester として追加され、Instagramの Tester Invites で招待を承認済みか確認してください。Dashboardにユーザー名を入力するだけでは不十分です。
2. Invalid OAuth access token が返ります
ホストが graph.instagram.com で、Tokenに余分な空白がなく、有効期限切れや取り消しでないことを確認します。Instagram Login Tokenを graph.facebook.com のBusiness Discoveryへ送らないでください。
3. Tried accessing nonexisting field が返ります
フィールド名と対象オブジェクトを確認します。自分のプロアカウントは followers_count、Messaging User Profile APIは follower_count です。
4. Explorerでは動きますが、自分のプログラムでは動きません
同じToken、APIホスト、バージョンを使っているか確認します。Authorization: Bearer ヘッダーを使い、サーバーがTokenを途中で切っていないか調べてください。
5. Tokenが漏えいした場合はどうしますか
Meta/Instagramの認証設定ですぐに取り消し、再生成してください。チャット、ログ、画像、リポジトリに出たTokenはすべて漏えい済みとして扱います。