Instagram Profiles
Instagramプロフィールは、ユーザー名、表示名、プロフィール文、プロフィール画像、外部リンク、アカウントカテゴリ、認証・非公開の状態、表示中のフォロワー数・フォロー数・投稿数を含む公開アカウントページです。これらの識別情報、分類、オーディエンス指標は、プロフィール情報の補完、アカウント比較、リストの整備、特定時点のモニタリングに活用できます。
Instagram Profiles API の主な機能
- 既知のユーザー名で検索指定した1つ以上の公開ユーザー名を照会し、見つかったアカウントごとに最大1件の正規化プロフィールレコードを返します。
- アカウント情報とプロフィールリンクアカウントID、ユーザー名、表示名、正規プロフィールURL、プロフィール画像、プロフィール文、外部URL、プロフィール文内の公開リンクを返します。
- アカウントの分類とステータス表示されている認証・非公開の状態に加え、公開カテゴリ、ビジネスアカウント、プロアカウントの各属性を保持します。
- 表示中のプロフィール数値フォロワー数・フォロー数・投稿数を metrics にまとめ、正規化レコードに collected_at のタイムスタンプを付与します。
Instagram Profiles API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
usernames | 必須 | 必須。公開Instagramユーザー名の空でないリストです。先頭の @ は受け付け、検索前に除去されます。 |
Instagram Profiles API の使い方
既知のユーザー名を非同期タスクとして送信し、タスクIDをポーリングして、取得できた公開プロフィールレコードをカーソルページネーションで読み取ります。
- 取得したい既知の公開アカウントを含む、空でない usernames 配列を用意します。
- usernames 配列を /v1/instagram/profiles に POST し、返された task_id を保存します。
- status が succeeded または failed になるまで /v1/tasks/{task_id} をポーリングします。
- 成功したら 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 trueInstagram Profiles API の主なユースケース
- 既知アカウントの情報補完: Instagramユーザー名をすでに持つレコードに、固定ID、表示名、プロフィール文、プロフィール画像、正規URL、公開リンクを追加します。
- 選定アカウントの比較: 指定したユーザー名のグループ全体で、表示中の認証状態、カテゴリ、アカウント種別、フォロワー数・フォロー数・投稿数を比較します。
- プロフィールのスナップショット監視: 繰り返し取得した表示中のアカウント数値とともに collected_at を保存し、特定時点のプロフィールレコードを比較します。
Instagram Profiles API 活用のヒント
- このエンドポイントは usernames 配列のみを受け付けるため、プロフィールURLや検索語ではなくユーザー名を送信してください。
- 送信前に先頭の @ を取り除いて重複を排除し、name と @name が別々に検索されないようにしてください。
- 存在しない、名前が変更された、またはアクセスできないアカウントはレコードを返さないことがあるため、返されたユーザー名を入力リストと照合してください。
- 取得できなかった数値やアカウント属性は、0 や false に変換せず不明な値として保持してください。
- プロフィールのスナップショットを繰り返し比較する場合は、metrics とあわせて collected_at を保存してください。
関連API
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 Search API
- Instagram Comments API
- Instagram Hashtag Posts API
- Instagram Tagged Posts API
- Instagram Transcript API
- Instagram Audio Reels API
- Instagram Highlight Items API
- Instagram Post Info API
- Instagram Reels Search API
- Instagram Story Highlights API
- Instagram Trending Reels API
- Instagram Stories API
- Instagram Similar Accounts API
- Instagram Comment Replies API
- Instagram Post Likers API
- Instagram Location Info API
- Instagram Location Posts API
- Instagram Location Search API
- Instagram Hashtag Search API