instagram/
following-list

Instagramアカウントがフォローしている公開プロフィールを収集し、正規化されたユーザー名、プロフィールリンク、公開状態のシグナル、フォロー関係の情報、表示中の数値を返します。

Instagram Following List API

フォロー関係
公開プロフィール
ユーザー名の一括指定
結果1件あたり0.3クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Instagram Following List

Instagramフォロー中一覧のレコードは、取得元のユーザー名がフォローしている公開プロフィールを表し、正規化されたアカウント情報、プロフィールURL、公開状態のシグナル、フォロー関係の情報を含みます。繰り返し収集することでフォロー関係のスナップショットとして活用でき、collected_at、source_username、position によって各レコードをいつ、どこで観測したかを保持できます。

Instagram Following List API の主な機能

  • 取得元ユーザー名の一括指定先頭の @ を付けずに、1つ以上の公開Instagramユーザー名を1つのタスクで送信できます。
  • フォロー関係の取得元情報extra に source_username、relationship、position を保持し、各プロフィールを取得元アカウントまでたどれるようにします。
  • 正規化されたプロフィール情報取得できる場合は、プロフィールID、ユーザー名、表示名、正規プロフィールURL、アバター、公開されている認証・非公開のシグナルを受け取れます。
  • 表示中のアカウント指標収集したレコードに公開値が含まれている場合は、返されたフォロワー数・フォロー数・投稿数を利用できます。
  • 非同期での結果ページング収集処理をリクエストスレッドの外で実行し、タスクのステータスをポーリングして、next_cursor で正規化された結果をページ送りで取得します。

Instagram Following List API のパラメータ

パラメータ必須説明
usernames必須@ を付けない1つ以上の公開Instagramユーザー名です。カンマまたは改行で区切って指定します。
results_limit任意取得元のユーザー名ごとにリクエストするフォロー中プロフィールの最大件数です。1〜2,000の整数で指定し、デフォルトは100です。

Instagram Following List API の使い方

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

  1. 先頭に @ を付けない1つ以上の公開Instagramユーザー名を用意します。
  2. usernames と、1〜2,000の範囲で任意の results_limit を /v1/instagram/following-list に POST します。
  3. status が succeeded または failed になるまで /v1/tasks/{task_id} をポーリングします。
  4. /v1/tasks/{task_id}?limit=50 を読み取り、has_more が true の場合は results.next_cursor で続きを取得します。
curl -X POST "https://api.socq.ai/v1/instagram/following-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 GET /v1/tasks/{task_id}?limit=50 and follow data.results.next_cursor

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

  • クリエイターネットワークのマッピング: 選んだアカウントがどの公開クリエイター、メディア、組織をフォローしているかを、確認しやすいマップとして整理します。
  • ブランドアカウントの調査: ブランド、キャンペーン、地域別、競合の各アカウントで、表示されているフォロー関係を比較します。
  • パートナー候補の発見: パートナーシッププログラムに関連するアカウントのフォロー中一覧に現れる公開プロフィールを特定します。
  • プロフィールリストの情報補完: 社内のリストに、正規URL、表示名、アバター、アカウントのシグナル、フォロー関係の取得元情報を追加します。
  • フォロー関係の変化の追跡: タイムスタンプ付きのスナップショットを保存し、実行ごとに固定のプロフィールIDを比較して追加や削除を確認します。

Instagram Following List API 活用のヒント

  • 送信前にすべてのユーザー名から先頭の @ を取り除いてください。プロバイダーへの入力は、@ なしのユーザー名に正規化されます。
  • まずは絞り込んだ results_limit で始め、ワークフローでより多くのフォロー関係が必要な場合にのみ増やしてください。
  • 同じフォロー先プロフィールが複数の取得元アカウントで現れることがあるため、プロフィールIDは extra.source_username とあわせて保存してください。
  • アバター、アカウント指標、認証シグナル、位置が欠けていても、公開結果では通常起こり得るばらつきとして扱ってください。
  • 非公開、制限付き、削除済み、ログインが必要なフォロー関係は対応範囲外のため、結果が空または部分的になるケースを想定して設計してください。

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

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

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

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

Instagram Following List API — よくある質問

Instagram Following List APIは、送信したInstagramユーザー名のフォロー中一覧に表示される公開プロフィールのレコードを取得するためのプログラムインターフェースです。正規化されたアカウント情報、プロフィールURL、公開状態のシグナル、取得元アカウントの情報、リスト内の位置、取得可能なアカウント指標を返します。

Followingは表示されているフォロー関係から個々の公開プロフィールのレコードを返します。一方、Followers Countはフォロー関係の一覧を含まず、プロフィール単位のオーディエンス数と投稿数の合計を返します。

レコードには、ID、ユーザー名、表示名、プロフィールURL、アバターURL、認証・非公開のシグナル、表示中の指標、collected_at、source_username、relationship、position が含まれる場合があります。

はい。usernames 配列に1つ以上の公開ユーザー名を指定してください。source_username フィールドがある場合は、各フォロー関係レコードがどの入力アカウントから取得されたかを識別できます。

返されるのは公開プロフィールで確認できるフォロー関係のみです。非公開、制限付き、削除済み、ログインが必要なフォロー関係のデータでは、結果が部分的または空になる場合があります。

完了したタスクを1ページあたり最大500件の limit で読み取り、results.has_more が true の間は次のリクエストで results.next_cursor を渡してください。

成功した正規化結果は1レコードにつき0.3クレジットで課金され、基本料金はかかりません。結果が空の場合は基本料金のみのポリシーが適用されるため、0クレジットになります。