Skip to main content
GET
このエンドポイントは、認証済みのユーザーまたはユーザープロファイルに関する詳細情報を取得します。以下を含みます:
  • 連携済みのすべてのソーシャルメディアアカウントの包括的なリスト
  • ソーシャルメディアのユーザー名とプロファイル情報
  • アカウントのステータスと使用量メトリクス
返されるデータは、最後の更新時点における接続済みソーシャルネットワークの状態を反映しており、ユーザーがソーシャルメディアアカウントを接続または切断するたびに更新されます。
レスポンスのキャッシュ。 レスポンスは最大 60 秒間 キャッシュされます。lastUpdated および nextUpdate フィールドはそのキャッシュウィンドウを表します。lastUpdated はスナップショットが作成された時刻、nextUpdate はその有効期限です。nextUpdateキャッシュの有効期限マーカーであり、準備完了のシグナルではありません。 これはすべてのレスポンスに付与されるため、直前に通知を受け取ったアカウントがまだ displayNames に含まれていないレスポンスにも付与されます。したがって、新しくリンクされたアカウントの伝播が完了したタイミングを知る手段としては利用できません。新しくリンクされたアカウントについて social webhook を照合している場合は、期待するアカウントが実際に displayNames に表示されるまでポーリングしてください。単一のレスポンスや nextUpdate の到来を、リンクが存在しない、または完了したことの確認として扱わないでください。
ソーシャルアカウントが連携されていない場合、activeSocialAccounts は返されません。 特定の User Profile のデータを取得するには、Profile-Key を header に追加 してください。
  • すべてのユーザープロファイルのデータを一度に取得する必要がある場合は、/user/batch エンドポイント を使用してください。
  • ユーザーがソーシャルアカウントを連携または切断したときの通知が必要な場合は、/webhooks エンドポイント を参照してください。

Header Parameters

Query Parameters

boolean
デフォルト:false
アカウントタイプ(ビジネスまたはクリエイター)や使用済みクォータなど、Instagram の追加詳細を返します。 追加データが必要な場合以外は、レスポンス時間が遅くなるため推奨しません。