Truth Social Profile
Truth Social Profileは、既知の公開アカウントを照会します。ユーザー名を送信すると正規化されたアカウントレコードが1件返され、そのまま情報補完、確認作業、定期的なプロフィールのスナップショットに利用できます。
Truth Social Profile API の主な機能
- ユーザー名による正確な照会あいまいなアカウント検索やプロフィールURLではなく、1タスクにつき既知の公開ユーザー名を1件照会します。
- 一貫したアカウント情報アカウントID、ユーザー名、表示名、公開プロフィールURL、プロフィール文、取得日時を固定のフィールドで受け取れます。
- プロフィールの詳細公開されている場合は、アバター、カバー画像、Webサイト、所在地、認証状態、非公開設定を取得します。
- 表示中の指標のスナップショット取得時点のフォロワー数・フォロー数・投稿数を記録し、後から比較できるようにします。
Truth Social Profile API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
username | 必須 | 必須。ASCIIの英字、数字、ピリオド、アンダースコア、ハイフンで構成される1〜64文字の公開ユーザー名です。検証では先頭の @ を1つまで許容しますが、@ を付けない正規のユーザー名を推奨します。プロフィールURLは使用できません。 |
Truth Social Profile API の使い方
公開ユーザー名を1件送信してタスクIDを保存し、完了後にアカウントの結果を読み取ります。
- realDonaldTrump などの既知のTruth Socialユーザー名を入力します。確実に照会するため、先頭の @ を付けずに指定してください。
- username を /v1/truth-social/profile に POST し、レスポンスの data.task_id を保存します。
- data.status が succeeded または failed になるまで GET /v1/tasks/{task_id} をポーリングします。
- 成功したら、data.results.items から正規化されたアカウントレコードを読み取ります。
curl -X POST "https://api.socq.ai/v1/truth-social/profile" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username":"realDonaldTrump"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items after successTruth Social Profile API の主なユースケース
- アカウント情報の補完: ユーザー名をすでに持つレコードに、公開アカウント情報、プロフィール文、プロフィール画像、Webサイト、表示中の指標を追加します。
- アカウントの確認: 公開プロフィールを一貫したフィールドに変換し、社内での確認、分類、目視チェックに活用します。
- プロフィールの変化の追跡: 定期的にスナップショットを保存し、collected_at を使ってプロフィール文、画像、状態、指標を比較します。
Truth Social Profile API 活用のヒント
- 同じアカウントが複数の表記で保存されないよう、@ を付けない正規のユーザー名で保存してください。
- 構文が正しくても、アカウントが存在する、公開されている、または現在アクセス可能であることは保証されません。
- プロフィール画像、Webサイト、所在地、状態、指標は、null になり得るソースフィールドとして扱ってください。
- このエンドポイントはアカウントの詳細のみを返します。公開投稿には Truth Social User Posts API を使用してください。
- results_limit やソースのカーソルは送信しないでください。各タスクではアカウントの照会を1回行います。
関連API
Truth Social Profile API 以外に別の種類の公開Truth Socialデータが必要な場合は、これらのAPIをご利用ください。
- Truth Social Post API — 既知のTruth Social投稿URL 1件から、正規化されたコンテンツ、投稿者情報、メディア、タイムスタンプ、取得可能な表示中のエンゲージメントの各フィールドを取得します。
- Truth Social User Posts API — ユーザー名または数値のアカウントIDから、公開Truth Social投稿を取得元の1ページ分取得し、正規化されたコンテンツ、投稿者、メディア、タイムスタンプ、表示中のエンゲージメントを返します。