メインコンテンツへスキップ
GET
プライマリプロファイルに関連付けられたすべてのプロファイルを取得します。Primary Profile は結果に含まれません。 セキュリティ上の理由から、Profile Keys はこの GET 呼び出しでは返されません。詳細は こちら を参照してください。

Header Parameters

Query Parameters

title
string
URL エンコードされたタイトルに関連付けられたプロファイルのみを返します。
refId
string
指定された refId に関連付けられたプロファイルのみを返します。refId は、プロファイル作成時または /user エンドポイントから返されます。
hasActiveSocialAccounts
boolean
デフォルト:false
true の場合、接続されたソーシャルアカウントを少なくとも 1 つ持つプロファイルのみを返します(activeSocialAccounts の長さが 0 より大きい)。false の場合、接続されたソーシャルアカウントが 0 のプロファイルのみを返します(activeSocialAccounts の長さが 0)。
includesActiveSocialAccounts
array
activeSocialAccountsincludesActiveSocialAccounts リストで指定されたソーシャルメディアプラットフォームがすべて含まれるプロファイルにフィルターします。プロファイルの activeSocialAccountsincludesActiveSocialAccounts にリストされているもの以外のプラットフォームが追加で含まれていても、フィルタリングされた結果に含まれます。値: blueskyfacebookgmbinstagramlinkedinpinterestredditsnapchattelegramthreadstiktoktwitteryoutube
isByokLinked
boolean
BYOK(Bring Your Own Key)移行ステータスでプロファイルをフィルターします。true の場合、BYOK 移行を完了したプロファイルのみを返します。false の場合、BYOK 対応プラットフォームが接続されているがまだ移行されていないプロファイルのみを返します。BYOK 対応プラットフォームを持たないプロファイルは、このフィルターが設定されている場合に除外されます。省略された場合、BYOK ステータスに関係なくすべてのプロファイルが返されます。現在は X/Twitter BYOK に適用されます。
actionLog
boolean
デフォルト:false
過去 60 日間の User Profile 作成・削除アクションログ履歴と、過去 60 日間の課金に使用されたアクティブユーザー数を返します。注意:
  • アクションログ: タイトルとタグは、2025 年 3 月より前のアクションログ履歴には返されません。
  • User Profile レポート: 期間は請求期間と一致しない場合があります。たとえば、請求期間は月の 10 日に開始および終了する場合があります。 請求期間およびその他の詳細については、請求書を参照してください。
actionLog に日数を設定することで、異なる期間を指定できます。たとえば、 actionLog=10 クエリパラメータは、過去 10 日間のアクションログと過去 10 日間のレポート済みアクティブユーザー数を返します。許可される期間は 1 日から 365 日までです。
limit
number
デフォルト:5000
返されるプロファイルの数を制限します。デフォルトおよび最大は 5000 です。
cursor
string
返す追加のプロファイルがあり、hasMore フラグが true の場合、レスポンスに nextCursor が返されます。 次のプロファイルのセットを返すには、このカーソルを cursor クエリパラメータに渡します。
include
string | array
トラブルシューティング用の拡張プロファイルデータを返します。refId パラメータ(単一プロファイル検索)が必要です。値(カンマ区切りの文字列または配列): suspensionsocialHealthlinkingErrorsactivityquotaunlinkHistoryactionLog
  • suspension - isSuspended、reason、suspendedAt、unsuspendAt、suspensionCount
  • socialHealth - プラットフォーム別: linked、linkedAt、relinkRecommended、messagingEnabled、tokenExpiresAt
  • linkingErrors - プラットフォーム別: code、message、details、createdAt
  • activity - lastApiCall、lastPost タイムスタンプ
  • quota - used、limit
  • unlinkHistory - 最後のリンク解除: platform、source(user/system)、details、createdAt
  • actionLog - プロファイルアクション履歴(create/update/delete)