API で取得する Instagram のフォロワー属性
Instagram のアカウントインサイトのエンドポイントは、metric=follower_demographics、period=lifetime、metric_type=total_value、timeframe を指定し、breakdown に age、gender、city、country のいずれかを指定すると、フォロワーの属性を返します。engaged_audience_demographics も同様に、コンテンツに反応したアカウントの属性を返します。Meta が返すのは上位 45 件の値のみです。フォロワーの属性には 100 フォロワーが、engaged_audience_demographics には期間内に 100 件のエンゲージメントが必要です。
easyCoexistence は get_social_insights で Instagram のフォロワーとエンゲージしたオーディエンスの人口統計を読み取るため、Claude、ChatGPT、または自社のコードから、どの国、都市、年齢層がアカウントをフォローしているかを尋ね、接続されたアカウントについての Meta の数値を取得できます。
これを下回ると、そのアカウントでは follower_demographics が返されません。
engaged_audience_demographics を返すには、期間内にこの件数のエンゲージメントが必要です。
上位 45 件のみ返すため、小規模な都市や国は含まれません。
last_14_days、last_30_days、last_90_days、prev_month が engaged_audience_demographics で動作しなくなった時期(全バージョン)。
アカウント指標の元データが遅延しうる最大時間。
どのデモグラフィック指標がありますか?
Meta のアカウントインサイトのリファレンスにある 2 つは、どちらも GET /<IG_ID>/insights で読み取ります。古いコードがまだ要求する 2 つのセットもあります:
follower_demographics:アカウントのフォロワーの人口統計的特徴。engaged_audience_demographics:同じ属性を、コンテンツに反応したアカウントについて示します。- どちらも period は lifetime、
metric_typeはtotal_valueで、timeframe と、age、city、country、gender のいずれかの breakdown を指定します。 audience_gender_age、audience_locale、audience_country、audience_city:2023 年 12 月 11 日に廃止されました。reached_audience_demographics:Meta の 2024 年の変更履歴には記載されていますが、現在の指標一覧には載っていません。
フォロワーの属性はどうリクエストしますか?
指標に加えて period=lifetime、metric_type=total_value、timeframe、breakdown を 1 つ指定します。timeframe は since と until の代わりに使います。デモグラフィック指標はこの 2 つをサポートしないため、timeframe は必須です。Instagram Login の場合、トークンには instagram_business_basic と instagram_business_manage_insights が必要で、呼び出し先は graph.instagram.com です:
GET https://graph.instagram.com/<IG_ID>/insights
?metric=follower_demographics
&period=lifetime
&timeframe=this_month
&breakdown=country
&metric_type=total_value
&access_token=<INSTAGRAM_USER_ACCESS_TOKEN>レスポンスはどのような形式ですか?
件数は total_value.breakdowns に入ります。dimension_keys にはリクエストした timeframe と breakdown の名前が入り、各結果は dimension_values(timeframe と breakdown の値 1 つ)と件数の組になります。Meta のサンプルでは、エンゲージしたオーディエンスを国別に見た場合、国は US や ES のような 2 文字のコードで返されます:
{
"data": [
{
"name": "follower_demographics",
"period": "lifetime",
"title": "<TITLE>",
"description": "<DESCRIPTION>",
"total_value": {
"breakdowns": [
{
"dimension_keys": ["timeframe", "country"],
"results": [
{ "dimension_values": ["<TIMEFRAME>", "<COUNTRY_CODE>"], "value": <COUNT> },
{ "dimension_values": ["<TIMEFRAME>", "<COUNTRY_CODE>"], "value": <COUNT> }
]
}
]
},
"id": "<IG_ID>/insights/follower_demographics/lifetime"
}
]
}使える timeframe はどれですか?
Meta のリファレンスでは、両方の指標について last_14_days、last_30_days、last_90_days、prev_month、this_month、this_week が挙げられています。エンゲージしたオーディエンスについては、this_month は直近 30 日、this_week は直近 7 日と説明されています。engaged_audience_demographics では最初の 4 つが v20.0 から、そして 2024 年 8 月 19 日には全バージョンで動作しなくなったため、this_week か this_month を使ってください。その変更履歴には follower_demographics の記載はありません。
しきい値と制限はどうなっていますか?
Meta のアカウントインサイトのリファレンスでは、デモグラフィック指標について次のルールが定められています:
- 100 フォロワー未満のアカウントでは
follower_demographicsは返されません。 - 期間内のエンゲージメントが 100 件未満の場合、
engaged_audience_demographicsは返されません。 - 上位 45 件の値のみが返されるため、小規模な都市や国は除外されます。
- 人口統計データのあるビューアーのみが集計されるため、値の合計はフォロワー数を下回る場合があります。
- データがない場合は 0 ではなく空の結果が返されます。また、データは最大 48 時間遅延することがあります。
- 要求した指標がサポートしない breakdown を指定すると、リクエスト全体が「不明なエラーが発生しました」で失敗します。
Instagram Login でもデモグラフィックは使えますか?
はい。Meta は 2025 年 1 月 21 日に、Instagram Login アプリにアカウントとメディアのインサイトを開放しました。アカウントインサイトのリファレンスには、Instagram Login と instagram_business_basic、instagram_business_manage_insights の権限、そしてホストとして graph.instagram.com が挙げられています。Meta の Instagram Platform の要件どおり、アカウントはビジネスアカウントまたはクリエイターアカウントである必要があります。
get_social_insights はデモグラフィックをどう読み取りますか?
metrics に follower_demographics または engaged_audience_demographics、period に lifetime、params に timeframe、breakdown、metric_type を指定します。easyCoexistence は接続済みアカウントのトークンを使って、接続されたアカウントに対して GET /<IG_ID>/insights を呼び出し、Meta のレスポンスをそのまま返します。そのため Claude や ChatGPT は、どの国、都市、年齢層がアカウントをフォローしているかを答えられます。
{
"account_id": "<ACCOUNT_ID>",
"metrics": ["follower_demographics"],
"period": "lifetime",
"params": {
"timeframe": "this_month",
"breakdown": "age",
"metric_type": "total_value"
}
}よくある間違い
- since と until を渡すこと。デモグラフィック指標はこの 2 つをサポートしません。timeframe で期間を指定し、これは必須です。
- エンゲージしたオーディエンスに last_30_days や last_90_days を使うこと。これらの timeframe は 2024 年 8 月 19 日以降、全バージョンで engaged_audience_demographics では動作しなくなりました。
- 内訳の値を合計してフォロワー数を求めること。デモグラフィックのデータがあるビューアーのみが集計され、上位 45 件の値しか返らないため、合計は足りなくなります。
- 小規模なアカウントでデータを期待すること。フォロワー属性には 100 フォロワー、エンゲージしたオーディエンスには期間内に 100 件のエンゲージメントが必要です。
接続 1 件あたり月額 US$ 9 から、接続を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料トライアルです。
よくある質問
Instagram アカウントでデモグラフィックを取得するにはフォロワーが何人必要ですか?
100 フォロワーです。これを下回ると、Meta は follower_demographics を返しません。engaged_audience_demographics には期間内に 100 件のエンゲージメントが必要です。
なぜ Instagram は 45 都市しか返さないのですか?
Meta のデモグラフィック指標は上位 45 件の値だけを返すため、小規模な都市や国は除外されます。
Instagram API で audience_gender_age の代わりになったものは何ですか?
follower_demographics です。age、gender、city、country の breakdown を指定します。Meta は 2023 年 12 月 11 日に audience_gender_age、audience_locale、audience_country、audience_city を廃止しました。
follower_demographics で since と until を使えますか?
いいえ。デモグラフィック指標は since と until をサポートしません。代わりに timeframe パラメータで期間を指定し、これは必須です。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日