API 経由で取得する Instagram のフォロワー数とプロフィール項目
Instagram API では、プロフェッショナルアカウントのフォロワー数が followers_count フィールドで返されます。同じレスポンスには follows_count、media_count、username、name、profile_picture_url、account_type も含まれます。Instagram Login の場合は、これらのフィールドを指定して graph.instagram.com 上で GET /me を呼び出し、instagram_business_basic の権限で読み取ります。Meta の IG User リファレンスには biography と website も記載されており、フォロワー数の推移はインサイトから取得します。
easyCoexistence は、Instagram Login で Instagram ビジネスアカウントまたはクリエイターアカウントを接続します。
このアカウントをフォローしている Instagram ユーザーの総数。Meta の IG User リファレンスで public と記されているフィールドです。
Meta の Instagram Login ガイドに記載されている User フィールド。id と user_id から followers_count、media_count まで。
クリエイターアカウントの account_type の値。ビジネスアカウントでは Business と返されます。
この数を下回る場合、Meta はそのアカウントについて follows_and_unfollows と follower_count のインサイトを返しません。
Instagram Login で返されるプロフィール項目は何ですか?
Meta の Instagram Login ガイドが User オブジェクトについて挙げる 9 つのフィールドで、fields の一覧を指定して GET /me で読み取ります。トークンには instagram_business_basic が必要です。以降の呼び出しでアカウントの IG_ID として使うのは、id ではなく user_id です:
フォロワー数はどのように取得しますか?
/me に followers_count を指定します。Meta のリファレンスでは、トークンに紐づくアカウントの User ノードを指します。この値は呼び出し時点の累計なので、グラフ化するダッシュボードでは毎日の値を自分で保存する必要があります。
GET https://graph.instagram.com/me
?fields=user_id,username,followers_count,follows_count,media_count
&access_token=<ACCESS_TOKEN>
{
"user_id": "<IG_ID>",
"username": "<USERNAME>",
"followers_count": 1840,
"follows_count": 312,
"media_count": 97
}Meta のリファレンスには、ほかにどのフィールドが載っていますか?
Meta の IG User リファレンスは 3 つの構成をまとめて説明しており、Instagram Login ガイドの 9 つを超えるフィールドを追加で挙げています。一部には Page 連携のアカウントで利用できると明記されており、残りにはログインに関する注記がありません:
- biography:プロフィールの自己紹介文。public と明記されています。
- website:アカウントのウェブサイト URL。public と明記されています。
has_profile_pic:アカウントにプロフィール画像があるかどうか。is_publishedとlegacy_instagram_user_id:Page 連携アカウント向けの項目。後者は v21.0 までの Marketing API エンドポイント用に作られた ID です。shopping_product_tag_eligibility:アカウントで Instagram ショップを設定済みかどうか。
フォロワーの増加はどのように追跡しますか?
プロフィールではなく、アカウントのインサイトから取得します。metric=follows_and_unfollows、metric_type=total_value、follow_type の内訳を指定して GET /<IG_ID>/insights を呼び出すと、フォローしたアカウントと、フォローを解除したか Instagram を退会したアカウントが返されます。Instagram Login では、トークンに instagram_business_manage_insights も必要です。follows_and_unfollows と follower_count は、フォロワーが 100 人以上のアカウントに限り返されます。
API でフォロワーの一覧を取得できますか?
いいえ。Meta の IG User リファレンスは followers_count と follows_count を数値で返し、その背後にあるアカウントを返すエッジは載っていません。代わりに、アカウントのインサイトで follower_demographics を利用できます。年齢、都市、国、性別で内訳を見られ、フォロワーが 100 人以上のアカウントが対象です。
ほかのアカウントのフォロワー数を読み取ることはできますか?
Facebook Login と Unified Login で利用できる Business Discovery を使います。GET /<IG_ID>?fields=business_discovery.username(<USERNAME>){followers_count,media_count} を呼び出すと、別のビジネスアカウントやクリエイターアカウントの値が返されます。読み取れるのは相手アカウントの public フィールドで、IG User リファレンスで public と明記されているもののうち、biography、followers_count、id、media_count、username、website などです。
easyCoexistence 経由でプロフィールを読み取るには?
list_social_accounts は、接続済みの各アカウントの username、name、external_id を返します。external_id がその IG_ID です。プロフィールの followers_count、follows_count、media_count といった数値にはツールがなく、Instagram のトークンは渡されません。代わりに get_social_insights が、follows_and_unfollows、reach、views でオーディエンスの動きを読み取ります。
よくある間違い
- フォロワーの一覧が返ってくると想定すること。Meta が返すのは数値と、フォロワーが 100 人以上の場合の属性別の内訳だけで、アカウント自体は返りません。
- followers_count だけで増加をグラフ化すること。これは累計値です。インサイトの follows_and_unfollows を使うと、新規フォローと解除を分けて把握できます。
- account_type が CREATOR かを確認すること。クリエイターアカウントは Media_Creator を返し、ビジネスアカウントは Business を返します。
- /me の id をアカウントの ID として使うこと。Meta のガイドでは、Webhook 通知や /<IG_ID>/media のようなパスに紐づくのは id ではなく user_id です。
これにより、Claude、ChatGPT、または自分のコードが、Meta の公式 API 経由で get_social_insights からリーチ、視聴数、フォローを読み取れます。プロフィールのフォロワー数と投稿数にはツールがありません。料金は接続 1 件あたり月額 US$ 9 から US$ 0.75 まで、接続を増やすほど下がります。3 日間の無料トライアル付きです。
よくある質問
Instagram API はプロフィールの自己紹介文を返しますか?
はい。biography として取得できます。Meta の IG User リファレンスでは public フィールドとして記載されています。Instagram Login ガイドの 9 個の User フィールドには含まれていないため、GET /me で要求し、お使いの設定でレスポンスを確認してください。
follows_and_unfollows が何も返らないのはなぜですか?
フォロワーが 100 人未満のアカウントには、Meta は返しません。
個人アカウントのフォロワー数は取得できますか?
いいえ。Meta の API はプロフェッショナルアカウント向けで、Business Discovery が読み取れるのはビジネスアカウントとクリエイターアカウントに限られます。
フォロワー数にはどの権限が必要ですか?
Instagram Login の場合は instagram_business_basic です。フォロワーのインサイトには、instagram_business_manage_insights を追加します。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日