instagram/
followers-count

ユーザー名またはプロフィールURLから公開Instagramプロフィールの詳細を取得し、正規化されたアカウント情報、認証状態、表示中のフォロワー数・フォロー数・投稿数を返します。

Instagram Followers Count API

プロフィールの数値
公開データ
一括取得に対応
結果1件あたり0.52クレジット
準備完了
準備完了

パラメータを入力してリクエストを送信してください。タスクのステータスと正規化された結果がここに表示されます。

README

SocQ 編集 · 更新

Instagram Followers Count

Instagramフォロワー数は、表示中のフォロワー数・フォロー数・投稿数の合計に、公開されているアカウント情報と認証シグナルを加えた、特定時点のプロフィールのスナップショットです。これらのフィールドは、オーディエンス規模の比較、クリエイターのベンチマーク、リストの情報補完、繰り返し収集による成長のモニタリングに活用できます。

Instagram Followers Count API の主な機能

  • 表示中のプロフィール数値公開されているInstagramプロフィールから、表示中のフォロワー数・フォロー数・投稿数を読み取ります。
  • ユーザー名とURLで入力1つ以上の公開ユーザー名、プロフィールURL、またはいずれかの入力形式による一括指定を受け付けます。
  • 数値のみの結果フォロワーやフォロー中の完全な一覧ではなく、数値に特化したレコードを返します。
  • アカウント情報フィールド各数値レコードに、公開されている表示名、プロフィールURL、アバター、認証状態、非公開状態を含めます。
  • 公開データの範囲非公開、削除済み、制限付き、ログインが必要なプロフィールデータはレスポンスの対象外です。

Instagram Followers Count API のパラメータ

パラメータ必須説明
usernames任意@ を付けない公開Instagramユーザー名です。カンマまたは改行で区切って指定します。usernames または urls のいずれかを指定してください。
urls任意任意。公開InstagramプロフィールのURLです。urls または usernames のいずれかを指定してください。
results_limit任意収集タスクがリクエストするレコードの最大件数です。正の整数で指定してください。

Instagram Followers Count API の使い方

ユーザー名またはプロフィールURLを非同期タスクとして送信し、タスクIDをポーリングして、正規化されたプロフィール指標をカーソルページネーションで読み取ります。

  1. @ を付けない1つ以上の公開Instagramユーザー名、または公開プロフィールURLを用意します。
  2. usernames または urls と任意の results_limit を /v1/instagram/followers-count に POST します。
  3. status が succeeded または failed になるまで /v1/tasks/{task_id} をポーリングします。
  4. /v1/tasks/{task_id}?limit=50 を読み取り、さらにレコードがある場合は results.next_cursor をたどって続きを取得します。
curl -X POST "https://api.socq.ai/v1/instagram/followers-count" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["natgeo","instagram"],"results_limit":25}'

# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.

Instagram Followers Count API の主なユースケース

  • クリエイターの成長モニタリング: 追跡しているクリエイターの公開フォロワー数・フォロー数を更新し、定期実行ごとの変化を比較します。
  • ブランド・競合の追跡: ブランド、競合、キャンペーン、パートナーアカウントの公開プロフィール数値の変化をモニタリングします。
  • オーディエンス分析: どの公開プロフィールに詳しい情報補完が必要かを判断する前に、数値指標を手軽なシグナルとして利用します。
  • CRM・クリエイターデータベースの情報補完: 既存のアカウントレコードに、公開されている数値指標、プロフィールURL、表示名、認証状態を追加します。
  • レポート用スナップショット: 各結果とあわせて collected_at を保存し、ダッシュボードで数値を更新した日時と取得元を表示できるようにします。

Instagram Followers Count API 活用のヒント

  • このエンドポイントは数値の取得に絞って使い、公開コンテンツのレコードも必要な場合は Posts API または Reels API を使用してください。
  • 公開されている数値は更新のたびに変わる可能性があるため、すべてのレコードで collected_at を保存してください。
  • バッチサイズは控えめにし、公開結果が一時的に取得できない場合はバックオフを入れてリトライしてください。
  • posts_count、avatar、認証状態のフィールドが欠けていても、公開結果では通常起こり得るばらつきとして扱ってください。
  • 非公開プロフィール、フォロワーの完全な一覧、ログインが必要なInstagramデータを前提にしたワークフローは設計しないでください。

Instagram Followers Count API 以外に別の種類の公開Instagramデータが必要な場合は、これらのAPIをご利用ください。

  • Instagram Posts API — ユーザー名から、公開投稿、メディア、ハッシュタグ、メンション、タイムスタンプ、エンゲージメントを取得します。
  • Instagram Profiles API — ユーザー名から、公開プロフィールのアカウント情報、プロフィール文、リンク、アカウント属性、カテゴリ、表示中のカウントを取得します。
  • Instagram Followers List API — 公開フォロワーのプロフィールレコードを、元のアカウントと関係性の情報とともに取得します。
  • Instagram Following List API — Instagramアカウントがフォローしている公開プロフィールを、アカウント情報、関係性の情報、表示中のアカウントのカウントとともに取得します。
  • Instagram Similar Accounts API — ユーザー名に対してInstagramが類似アカウントとして提案するアカウントを一覧で取得し、ユーザー名、名前、アイコン、認証バッジの有無を返します。
  • Instagram Post Likers API — 投稿URLの、表示されているいいねしたユーザーの一覧からアカウントを取得し、ユーザー名、名前、アイコン、認証バッジの有無を返します。

他のプラットフォームを見る

Instagramのデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

Instagram Followers Count API — よくある質問

Instagram Followers Count APIは、Instagramのユーザー名またはプロフィールURLから、公開されているプロフィールの詳細を取得するAPIです。正規化されたアカウント情報、認証状態、フォロワー数・フォロー数・投稿数を返します。

いいえ。このAPIは followers_count や following_count などの数値指標を取得するためのもので、個々のフォロワーやフォロー中のユーザーを書き出す用途には対応していません。

主なフィールドは、プロフィールID、username、profile_url、display_name、avatar、followers_count、following_count、posts_count、verified、private、collected_at です。公開プロフィールで公開されていない任意フィールドは、含まれない場合があります。

いいえ。公開プロフィールの収集では、アプリケーション側でInstagramアカウントのCookieやブラウザセッションを用意する必要はありません。

いいえ。このAPIは公開プロフィールの結果のみを扱うため、非公開、削除済み、制限付き、ログインが必要なプロフィールでは、データが限られるかレコードが返らない場合があります。

数値は、リクエストに対して収集された最新の公開プロフィール結果を反映しています。Instagramは公開カウンターを継続的に更新・キャッシュしているため、多少の差が生じることがあります。

バッチサイズを控えめにし、一時的な失敗はバックオフを入れてリトライし、同じプロフィールを高頻度で繰り返し更新しないようにしてください。公開結果が取得できないケースも、ワークフローで通常どおり処理すべきものとして扱ってください。