Instagram Business Discovery:他のアカウントの投稿とフォロワー数を読み取る
Instagram の Business Discovery では、ユーザー名を指定して他のビジネスアカウントやクリエイターアカウントの公開データを読み取れます。取得できるのは、フォロワー数とメディア数、biography や website などの公開プロフィール項目、そして投稿ごとのいいね数、コメント数、表示回数です。自分のプロフェッショナルアカウントから、Facebook Login または Unified Login を使って GET /<IG_ID>?fields=business_discovery.username(<USERNAME>){followers_count,media_count} を呼び出します。
easyCoexistence は、Instagram Login で自分の Instagram ビジネスアカウントまたはクリエイターアカウントを接続します。
Business Discovery は、Facebook Login と Unified Login を使う Instagram API で利用できます。
instagram_basic、instagram_manage_insights、pages_read_engagement の権限が必要で、Facebook Login によるユーザーアクセストークンで取得します。
Business Discovery がデータを返さないプロフェッショナルアカウントがあります。
Business Discovery がビジネスアカウントに加えて、他のクリエイターアカウントのデータも返すようになった時点です。
Business Discovery の呼び出しに適用されるレート制限は、Instagram の他のエンドポイントの制限とは異なります。
Business Discovery のリクエストはどのように動作しますか?
これは自分のアカウント上のフィールドとして呼び出します。管理しているプロフェッショナルアカウントに対して GET /<IG_ID> をリクエストし、fields=business_discovery.username(<USERNAME>) を指定します。中かっこ内には、他のアカウントについて取得したいフィールドを並べます。レスポンスでは、結果が自分のアカウントの id と並んで business_discovery の下にネストされて返されます。
GET /<IG_ID>?fields=business_discovery.username(bluebottle){followers_count,media_count}
{
"business_discovery": {
"followers_count": 267788,
"media_count": 1205,
"id": "17841401441775531"
},
"id": "<IG_ID>"
}どのフィールドを取得できますか?
Meta のリファレンスで公開として定められている、他のアカウントの公開フィールドとメディアです。
- プロフィール: 公開とマークされている IG User フィールド (biography,
followers_count, id,media_count, username, website など)。 - メディア: メディアのエッジで、投稿ごとに
comments_count、like_count、view_countなどのフィールドを取得できます。 view_count: Business Discovery を経由した場合のみ利用でき、有料と オーガニック の表示回数を合わせて数えます。media_url: 著作権のある音源やライセンス音源を含む動画、およびオーナーがダウンロードを無効にした Reels では省略されます。
他のアカウントの投稿はどのように取得しますか?
business_discovery の中で media を展開し、各投稿について取得したいフィールドを並べます。メディアのエッジは before と after のカーソルでページングされますが、next や previous のフィールドはありません。そのため、次のリクエストは after カーソルから自分で組み立てるように Meta は案内しています。返されるメディア ID 単体では読み取れません。Meta によると、それらに対して GET を実行すると権限不足で失敗します。
GET /<IG_ID>?fields=business_discovery.username(bluebottle){media{id,permalink,timestamp,comments_count,like_count,view_count}}どのアカウントを読み取れますか?
ユーザー名で検索できる Instagram のビジネスアカウントとクリエイターアカウントです。クリエイターアカウントは 2019 年 8 月から対象になっています。年齢制限のあるプロフェッショナルアカウントのデータは返されず、個人アカウントは Instagram API の対象外です。返されるのは公開データで、Meta の概要ページが、アプリのユーザーが作成していないコンテンツについて一部のエンドポイントが返すとしている、限定的な種類のデータです。
何が必要ですか?
Facebook Login によるユーザーアクセストークンで、instagram_basic、instagram_manage_insights、pages_read_engagement の権限が必要です。Facebook ページの役割が Business Manager 経由の場合は、ads_management または ads_read も必要です。Meta の Business Discovery ガイドには、Unified Login での設定も記載されています。呼び出しは、Instagram の他のエンドポイントを制限している Business Use Case の上限ではなく、Meta のプラットフォームのレート制限にカウントされます。
easyCoexistence で Business Discovery を使えますか?
easyCoexistence は、Instagram Login で Instagram と接続します。この接続で扱えるのは、接続したアカウント自身のプロフィール、投稿、コメント、DM、インサイトです。Business Discovery は Facebook Login と Unified Login で提供されるため、この接続の範囲外です。接続したアカウント自身については、get_social_insights でリーチ、視聴数、フォローを読み取れます。
よくある間違い
- メディア ID に対して GET を呼び出すこと。Meta は権限不足を理由に拒否します。代わりに business_discovery の中でフィールドをリクエストしてください。
- 個人アカウントを検索すること。Business Discovery が返すのはビジネスアカウントとクリエイターアカウントで、年齢制限のあるアカウントは除外されます。
- paging.next を待つこと。ここのメディアのエッジはカーソルしか返さないため、after カーソルを使って次のリクエストを自分で組み立ててください。
- view_count を自然なリーチとして読むこと。Meta は有料と オーガニック の表示回数を合算して、この値に含めています。
これにより、Claude、ChatGPT、または自分のコードが Meta の公式 API を通じて、フォロワー数と投稿数、投稿、コメント、インサイトを読み取れるようになります。接続したアカウントでは、投稿の公開や、コメントと DM への返信も行えます。接続 1 件あたり月額 US$ 9 から、接続を増やすほど US$ 0.75 まで下がります。最初の 3 日間は無料トライアルです。
よくある質問
Instagram API で競合他社のフォロワー数を確認できますか?
はい、ビジネスアカウントまたはクリエイターアカウントで、年齢制限がないものであれば可能です。Business Discovery は、Facebook Login または Unified Login を使ってユーザー名から followers_count を返します。
Business Discovery は Instagram Login で動作しますか?
いいえ。Meta は Business Discovery を Facebook Login と Unified Login の対象として挙げており、そのガイドには Instagram Login の設定は含まれていません。
Business Discovery のリクエストは何件まで送れますか?
Business Discovery は、Instagram の他のエンドポイントのアカウントごとの呼び出し枠ではなく、Meta のプラットフォームのレート制限の対象です。
アカウントのデータが何も返ってこないのはなぜですか?
そのアカウントが個人アカウントである場合、API の対象外です。年齢制限のあるアカウントの場合は、Meta がデータを返しません。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日