instagram/
followers-list

ユーザー名を指定して公開Instagramフォロワーのプロフィールを収集し、正規化されたアカウント情報、プロフィール画像、公開状態のフラグ、取得元の情報、リスト内の位置、収集日時を返します。

Instagram Followers List API

フォロワーのプロフィール
取得元の情報
公開されたつながり
結果1件あたり0.3クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Instagram Followers List

Instagramフォロワーは、指定したユーザー名のフォロワー一覧に表示されるプロフィールの公開リレーションレコードで、アカウント情報、プロフィール画像、認証・非公開のフラグ、取得元の情報、リスト内の位置、収集日時を含みます。これらのフィールドは、オーディエンスのサンプリング、複数アカウント間の重複チェック、プロフィールの選定、フォロー関係リストの調査に活用できます。

Instagram Followers List API の主な機能

  • 複数アカウントのフォロワー収集1つ以上のInstagramユーザー名を送信し、1つの非同期タスクですべての取得元アカウントのフォロワープロフィールをリクエストします。
  • 正規化されたフォロワー情報各フォロワー行について、取得可能なプロフィールID、ユーザー名、表示名、導出したプロフィールURL、公開プロフィール画像を返します。
  • 公開状態と取得元のシグナル値が公開されている場合は、認証フラグと非公開アカウントフラグに加えて、取得元のユーザー名とフォロワーとしての関係を保持します。
  • 観測時のリスト情報取得できる場合は取得元での位置と Actor のスクレイピング日時を保持し、タイムスタンプのフォールバックとしてSocQの収集日時を使用します。
  • ユーザー名ごとの件数制御results_limit は送信したユーザー名ごとに個別に適用されます。デフォルトは100で、1〜2,000の範囲で指定できます。

Instagram Followers List API のパラメータ

パラメータ必須説明
usernames必須必須。Instagramユーザー名の空でないリストです。各要素は空でない文字列である必要があり、先頭の @ は収集前に除去されます。
results_limit任意ユーザー名ごとにリクエストするフォロワープロフィールの最大件数です。デフォルトは100で、1〜2,000の整数を指定できます。

Instagram Followers List API の使い方

公開Instagramユーザー名を送信して非同期タスクを追跡し、収集が成功したら正規化されたフォロワープロフィールのレコードをページ送りで読み取ります。

  1. 1つ以上の公開Instagramユーザー名を用意します。先頭の @ は受け付け、収集前に除去されます。
  2. usernames と任意の results_limit を /v1/instagram/followers-list に POST し、返された task_id を保存します。
  3. タスクが成功するか失敗を返すまで /v1/tasks/{task_id} をポーリングします。
  4. data.results.items を読み取り、has_more が true の間は next_cursor をたどって続きを取得します。
curl -X POST "https://api.socq.ai/v1/instagram/followers-list" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["instagram"],"results_limit":100}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

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

  • 公開オーディエンスのサンプリング: 選んだ公開アカウントについて、フォロワーのユーザー名、表示名、プロフィールリンク、公開状態のフラグ、観測された位置を、件数を区切ったサンプルとして作成します。
  • 複数アカウント間の重複チェック: extra.source_username で行をグループ化してフォロワーIDやユーザー名を比較し、複数の送信アカウントに共通して現れるプロフィールを特定します。
  • プロフィール情報補完のキュー: プロフィール文や表示中のプロフィール数値が必要なワークフローでは、返されたユーザー名を選んで Instagram Profiles に渡します。
  • フォロー関係リストのスナップショット: フォロワーのアカウント情報、取得元のユーザー名、観測された位置、collected_at を保存し、後で取得した公開リストのサンプルと区別できるようにします。

Instagram Followers List API 活用のヒント

  • 上限とクレジットの見積もりは取得元アカウントごとに適用されるため、複数のユーザー名を送信する場合は、リクエストする件数を「ユーザー名の数 × results_limit」で見積もってください。
  • 取得元のユーザー名が @ で始まる場合でも、そのまま送信してかまいません。プロバイダーのマッパーが Actor の実行前に先頭の @ を除去します。
  • 同じフォロワープロフィールが複数の取得元リストに現れることがあり、取得元をまたいだ重複排除は保証されていないため、アカウントを比較する際は extra.source_username を保持してください。
  • position がある場合は、固定の順位や関係の強さを示す指標ではなく、観測時のリスト上の値として扱ってください。
  • 公開ソースから返された行がリクエスト数より少ない場合でも、部分的な結果を保持して collected_at を記録してください。非公開設定、アカウントの状況、ソース側のページネーション、Actor の制限によって出力が減ることがあります。

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

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

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

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

Instagram Followers List API — よくある質問

Instagram Followers List APIは、送信したInstagramユーザー名のフォロワー一覧に表示される公開プロフィールのレコードを取得するためのプログラムインターフェースです。取得できる場合は、正規化されたアカウント情報、プロフィール画像、公開状態のフラグ、取得元アカウントの情報、リスト内の位置、収集日時を返します。

usernames は必須で、空でない文字列からなる空でない配列で指定します。results_limit は任意で、ユーザー名ごとのデフォルトは100、1〜2,000の整数を指定できます。

レコードには、プロフィールID、ユーザー名、表示名、導出したプロフィールURL、プロフィール画像、認証・非公開のフラグ、収集日時に加え、取得元のユーザー名、関係、観測された位置を表す extra フィールドが含まれる場合があります。

いいえ。個々の公開フォロワーのプロフィール行を返します。プロフィールの表示中のフォロワー数・フォロー数・投稿数の合計が必要な場合は、Instagram Followers Count APIを使用してください。

いいえ。返されるのは対応している公開ソースで確認できる関係のみです。取得元アカウントが非公開、利用不可、またはユーザー名の誤りがある場合は、行が返らないことがあります。

results_limit はリクエストする最大件数であり、すべてを取得できることを保証するものではありません。プロフィールの非公開設定、アカウントの状況、Actor の制限、ソース側のページネーション、現在の公開フォロワー一覧の範囲によって、最終的な件数が減ることがあります。

返されたフォロワープロフィール1件につき0.3 SocQクレジットです。見積もりは「ユーザー名の数 × results_limit」で計算され、結果が空の場合は結果に対する課金は発生しません。