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

Header Parameters

Query Parameters

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

月間投稿クォータ

レスポンスには、プロファイルの月間投稿クォータの使用状況が表示されます。
  • monthlyPostCount:今月クォータにカウントされた投稿数。
  • monthlyPostQuota:月間の上限。クォータが 10,000 以上の場合(Business プランなど)は省略されます。上限は引き続き適用されます。
カウントは、請求日ではなく、毎月 1 日の 00:07 UTC にリセットされます。失敗した投稿の試行もカウントされます。monthlyApiCalls は別のカウンターであり、投稿クォータではありません。カウントされるものとクォータを使い切った場合の動作については、投稿数とAPI呼び出し数はどれくらい可能ですか? をご覧ください。