instagram/
profiles

1つ以上のユーザー名から公開Instagramプロフィールを取得し、正規化されたアカウント情報、プロフィール文、リンク、アカウント属性、表示中のフォロワー数・フォロー数・投稿数を返します。

Instagram Profiles API

既知のユーザー名で検索
プロフィールのメタデータ
アカウントのスナップショット
結果1件あたり0.6クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Instagram Profiles

Instagramプロフィールは、ユーザー名、表示名、プロフィール文、プロフィール画像、外部リンク、アカウントカテゴリ、認証・非公開の状態、表示中のフォロワー数・フォロー数・投稿数を含む公開アカウントページです。これらの識別情報、分類、オーディエンス指標は、プロフィール情報の補完、アカウント比較、リストの整備、特定時点のモニタリングに活用できます。

Instagram Profiles API の主な機能

  • 既知のユーザー名で検索指定した1つ以上の公開ユーザー名を照会し、見つかったアカウントごとに最大1件の正規化プロフィールレコードを返します。
  • アカウント情報とプロフィールリンクアカウントID、ユーザー名、表示名、正規プロフィールURL、プロフィール画像、プロフィール文、外部URL、プロフィール文内の公開リンクを返します。
  • アカウントの分類とステータス表示されている認証・非公開の状態に加え、公開カテゴリ、ビジネスアカウント、プロアカウントの各属性を保持します。
  • 表示中のプロフィール数値フォロワー数・フォロー数・投稿数を metrics にまとめ、正規化レコードに collected_at のタイムスタンプを付与します。

Instagram Profiles API のパラメータ

パラメータ必須説明
usernames必須必須。公開Instagramユーザー名の空でないリストです。先頭の @ は受け付け、検索前に除去されます。

Instagram Profiles API の使い方

既知のユーザー名を非同期タスクとして送信し、タスクIDをポーリングして、取得できた公開プロフィールレコードをカーソルページネーションで読み取ります。

  1. 取得したい既知の公開アカウントを含む、空でない usernames 配列を用意します。
  2. usernames 配列を /v1/instagram/profiles に POST し、返された task_id を保存します。
  3. status が succeeded または failed になるまで /v1/tasks/{task_id} をポーリングします。
  4. 成功したら data.results.items を読み取り、results.has_more が true の場合は results.next_cursor を渡して続きを取得します。
curl -X POST "https://api.socq.ai/v1/instagram/profiles" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["instagram","@natgeo"]}'

# Poll GET /v1/tasks/{task_id}?limit=50
# Read data.results.items and continue with results.next_cursor while results.has_more is true

Instagram Profiles API の主なユースケース

  • 既知アカウントの情報補完: Instagramユーザー名をすでに持つレコードに、固定ID、表示名、プロフィール文、プロフィール画像、正規URL、公開リンクを追加します。
  • 選定アカウントの比較: 指定したユーザー名のグループ全体で、表示中の認証状態、カテゴリ、アカウント種別、フォロワー数・フォロー数・投稿数を比較します。
  • プロフィールのスナップショット監視: 繰り返し取得した表示中のアカウント数値とともに collected_at を保存し、特定時点のプロフィールレコードを比較します。

Instagram Profiles API 活用のヒント

  • このエンドポイントは usernames 配列のみを受け付けるため、プロフィールURLや検索語ではなくユーザー名を送信してください。
  • 送信前に先頭の @ を取り除いて重複を排除し、name と @name が別々に検索されないようにしてください。
  • 存在しない、名前が変更された、またはアクセスできないアカウントはレコードを返さないことがあるため、返されたユーザー名を入力リストと照合してください。
  • 取得できなかった数値やアカウント属性は、0 や false に変換せず不明な値として保持してください。
  • プロフィールのスナップショットを繰り返し比較する場合は、metrics とあわせて collected_at を保存してください。

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

  • Instagram Followers Count API — 公開プロフィールのアカウント情報と、表示中のフォロワー数・フォロー数・投稿数を取得します。
  • Instagram Posts API — ユーザー名から、公開投稿、メディア、ハッシュタグ、メンション、タイムスタンプ、エンゲージメントを取得します。
  • Instagram Reels API — ユーザー名から、公開リール、メディア、オーディオ、ハッシュタグ、メンション、エンゲージメントを取得します。
  • Instagram Followers List API — 公開フォロワーのプロフィールレコードを、元のアカウントと関係性の情報とともに取得します。
  • Instagram Following List API — Instagramアカウントがフォローしている公開プロフィールを、アカウント情報、関係性の情報、表示中のアカウントのカウントとともに取得します。
  • Instagram Account Age Checker API — アカウントがInstagramに登録した時期、拠点となる国、認証された時期、ユーザー名の変更回数を確認します。

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

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

Instagram Profiles API — よくある質問

Instagram Profiles APIは、必須の usernames 配列に含まれる、照会可能なユーザー名ごとに正規化された公開プロフィールを1件ずつ取得するためのプログラムインターフェースです。アカウント情報、プロフィール文とリンク、認証・非公開フラグ、アカウントカテゴリ、表示中のフォロワー数・フォロー数・投稿数を返します。

usernames に空でない文字列を1つ以上指定します。値の先頭に @ を付けてもかまいません。プロフィールURL、キーワード検索、results_limit、投稿フィルターは使用できません。

レコードには、アカウントID、ユーザー名、表示名、プロフィールURLと画像、プロフィール文、外部リンクとプロフィール文内のリンク、認証・非公開フラグ、カテゴリ、ビジネス・プロアカウントの属性、表示中の数値、collected_at が含まれる場合があります。

存在しない、名前が変更された、利用できない、またはアクセスできないアカウントではレコードが返らないことがあり、公開ソース側の状況によって個別のフィールドが空になることもあります。同じタスク内の他の有効なユーザー名については、引き続きプロフィールレコードが返されます。

できません。このエンドポイントは、すでにわかっているユーザー名のプロフィールレコードを照会するものです。アカウントを探す場合は Instagram Search を、つながりのあるアカウントを取得する場合は Followers または Following エンドポイントを使用してください。

返された正規化プロフィール結果1件につき0.6クレジットです。結果が得られなかったユーザー名は、設定されている空結果ポリシーに従って処理されます。