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

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 の数値を取得できます。

100 followers

これを下回ると、そのアカウントでは follower_demographics が返されません。

100 engagements

engaged_audience_demographics を返すには、期間内にこの件数のエンゲージメントが必要です。

Top 45

上位 45 件のみ返すため、小規模な都市や国は含まれません。

19 Aug 2024

last_14_days、last_30_days、last_90_days、prev_month が engaged_audience_demographics で動作しなくなった時期(全バージョン)。

48 hours

アカウント指標の元データが遅延しうる最大時間。

どのデモグラフィック指標がありますか?

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 です:

Followers by country, this month
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 文字のコードで返されます:

The response shape, broken down by country
{
  "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 は、どの国、都市、年齢層がアカウントをフォローしているかを答えられます。

get_social_insights arguments for followers by age
{
  "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 件のエンゲージメントが必要です。
EasyCoexistence で実現する

接続 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 監視

確認日