truth-social/
profile

公開Truth Socialユーザー名を1件入力するだけで、正規化されたアカウント情報、プロフィール文、プロフィール画像、アカウントの状態、表示中の指標を取得できます。

Truth Social Profile API

ユーザー名で検索
アカウントプロフィール
1タスクあたり0.19クレジット
1リクエストあたり0.19クレジット
準備完了
準備完了

パラメータを入力してリクエストを送信してください。タスクのステータスと正規化された結果がここに表示されます。

README

SocQ 編集 · 更新

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を保存し、完了後にアカウントの結果を読み取ります。

  1. realDonaldTrump などの既知のTruth Socialユーザー名を入力します。確実に照会するため、先頭の @ を付けずに指定してください。
  2. username を /v1/truth-social/profile に POST し、レスポンスの data.task_id を保存します。
  3. data.status が succeeded または failed になるまで GET /v1/tasks/{task_id} をポーリングします。
  4. 成功したら、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 success

Truth Social Profile API の主なユースケース

  • アカウント情報の補完: ユーザー名をすでに持つレコードに、公開アカウント情報、プロフィール文、プロフィール画像、Webサイト、表示中の指標を追加します。
  • アカウントの確認: 公開プロフィールを一貫したフィールドに変換し、社内での確認、分類、目視チェックに活用します。
  • プロフィールの変化の追跡: 定期的にスナップショットを保存し、collected_at を使ってプロフィール文、画像、状態、指標を比較します。

Truth Social Profile API 活用のヒント

  • 同じアカウントが複数の表記で保存されないよう、@ を付けない正規のユーザー名で保存してください。
  • 構文が正しくても、アカウントが存在する、公開されている、または現在アクセス可能であることは保証されません。
  • プロフィール画像、Webサイト、所在地、状態、指標は、null になり得るソースフィールドとして扱ってください。
  • このエンドポイントはアカウントの詳細のみを返します。公開投稿には Truth Social User Posts API を使用してください。
  • results_limit やソースのカーソルは送信しないでください。各タスクではアカウントの照会を1回行います。

Truth Social Profile API 以外に別の種類の公開Truth Socialデータが必要な場合は、これらのAPIをご利用ください。

  • Truth Social Post API — 既知のTruth Social投稿URL 1件から、正規化されたコンテンツ、投稿者情報、メディア、タイムスタンプ、取得可能な表示中のエンゲージメントの各フィールドを取得します。
  • Truth Social User Posts API — ユーザー名または数値のアカウントIDから、公開Truth Social投稿を取得元の1ページ分取得し、正規化されたコンテンツ、投稿者、メディア、タイムスタンプ、表示中のエンゲージメントを返します。

他のプラットフォームを見る

Truth Socialのデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

Truth Social Profile API — よくある質問

Truth Social Profile APIは、ユーザー名をもとに、アカウント情報、プロフィール文、プロフィール画像、アカウントの状態、表示中の指標を含む正規化された公開アカウントレコードを取得します。

realDonaldTrump のように、@ を付けない公開ユーザー名を使用してください。ASCIIの英字、数字、ピリオド、アンダースコア、ハイフンを使用でき、最大64文字です。

結果には、アカウントID、ユーザー名、表示名、プロフィールURL、プロフィール文、アバター、カバー画像、Webサイト、所在地、認証状態と非公開設定、フォロワー数・フォロー数・投稿数が含まれる場合があります。

検証で確認されるのはユーザー名の形式のみです。取得時点でアカウントが存在しない、非公開である、または公開アクセスできない場合があります。

返されません。プロフィールデータのみを返します。公開投稿を取得するには Truth Social User Posts API を使用してください。

成功したタスク1件につき固定で0.19クレジットです。失敗したタスクは返金ポリシーに従って処理されます。