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

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 ビジネスアカウントまたはクリエイターアカウントを接続します。

followers_count

このアカウントをフォローしている Instagram ユーザーの総数。Meta の IG User リファレンスで public と記されているフィールドです。

9 fields

Meta の Instagram Login ガイドに記載されている User フィールド。id と user_id から followers_count、media_count まで。

Media_Creator

クリエイターアカウントの account_type の値。ビジネスアカウントでは Business と返されます。

100 followers

この数を下回る場合、Meta はそのアカウントについて follows_and_unfollows と follower_count のインサイトを返しません。

Instagram Login で返されるプロフィール項目は何ですか?

Meta の Instagram Login ガイドが User オブジェクトについて挙げる 9 つのフィールドで、fields の一覧を指定して GET /me で読み取ります。トークンには instagram_business_basic が必要です。以降の呼び出しでアカウントの IG_ID として使うのは、id ではなく user_id です:

idThe app user's app-scoped ID
user_idThe professional account's ID, the id in its webhook notifications
usernameThe account's username
nameThe profile name
account_typeBusiness or Media_Creator
profile_picture_urlThe profile picture's URL
followers_countAccounts following it
follows_countAccounts it follows
media_countMedia published on the account

フォロワー数はどのように取得しますか?

/me に followers_count を指定します。Meta のリファレンスでは、トークンに紐づくアカウントの User ノードを指します。この値は呼び出し時点の累計なので、グラフ化するダッシュボードでは毎日の値を自分で保存する必要があります。

Counts and username with Instagram Login
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 です。
EasyCoexistence で実現する

これにより、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 監視

確認日