truth-social/
post

公開Truth Social投稿のURLを1件入力するだけで、正規化された本文、投稿者、メディア、投稿日時、表示中のエンゲージメントデータを取得できます。

Truth Social Post API

投稿URL
単一投稿の詳細
1タスクあたり0.19クレジット
1リクエストあたり0.19クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Truth Social Post

Truth Social Postは、既知の公開投稿を1件照会します。投稿URLを送信すると、最大1件の正規化レコードが返され、リンク情報の補完、コンテンツの確認、定期的なエンゲージメントのスナップショットに活用できます。

Truth Social Post API の主な機能

  • URLによる正確な照会キーワード検索ではなく、1タスクにつき1件の公開 truthsocial.com 投稿URLを送信します。
  • 投稿内容一式投稿ID、公開URL、本文、投稿日時、取得日時を受け取れます。
  • 投稿者とメディアの情報取得可能な投稿者情報、アバター、アカウントの状態、メディア、ハッシュタグ、メンションを保持します。
  • エンゲージメントのスナップショット表示中のいいね数・コメント数・シェア数・閲覧数を記録し、取得できない値は null のまま保持します。

Truth Social Post API のパラメータ

パラメータ必須説明
url必須必須。公開Truth Social投稿の完全なURLです。解析後のホスト名は truthsocial.com またはそのサブドメインである必要があります。http または https を含め、実際の投稿パスを送信してください。

Truth Social Post API の使い方

実在する公開投稿のURLを送信してタスクIDを保存し、完了後に投稿の詳細を読み取ります。

  1. デフォルトの公開投稿URLを使うか、取得したいTruth Social投稿の完全なリンクに置き換えます。
  2. url を /v1/truth-social/post に POST し、レスポンスの data.task_id を保存します。
  3. タスクが成功または失敗するまで GET /v1/tasks/{task_id} をポーリングします。
  4. 成功したら、data.results.items から正規化された投稿レコードを読み取ります。
curl -X POST "https://api.socq.ai/v1/truth-social/post" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://truthsocial.com/@realDonaldTrump/117091934703272898"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items after success

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

  • 投稿リンクの情報補完: 既知の投稿リンクを、検索可能な本文、投稿者、タイムスタンプ、出典のフィールドに変換します。
  • 選定したコンテンツの確認: レビューワークフローの中で、特定の公開投稿の本文、投稿者、添付ファイルを取得します。
  • エンゲージメントの変化の追跡: 定期的に照会を繰り返し、公開エンゲージメントを collected_at とあわせて比較します。

Truth Social Post API 活用のヒント

  • プロフィール、検索ページ、その他のTruth Socialページではなく、実際の投稿の完全なURLを送信してください。
  • URLには http または https を含め、truthsocial.com またはそのサブドメインを使用する必要があります。
  • URLの検証を通過しても、投稿が存在すること、または公開アクセス可能な状態であることは保証されません。
  • 投稿者の詳細、メディア、ハッシュタグ、メンション、エンゲージメントデータは null になり得るフィールドとして扱ってください。
  • このエンドポイントは results_limit やソースのカーソルを受け付けず、1タスクにつき最大1件の投稿レコードを返します。

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

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

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

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

Truth Social Post API — よくある質問

Truth Social Post APIは、公開投稿のURLから、本文、投稿者、メディア、投稿日時、表示中のエンゲージメントデータを含む正規化された投稿の詳細を取得します。

http または https を含む公開投稿の完全なURLを送信してください。ホスト名は truthsocial.com またはそのサブドメインである必要があります。

推奨しません。このエンドポイントは特定の投稿を照会するため、実際の投稿パスを使用してください。同じドメインの別ページはホスト名の検証を通過しても、結果が返らないことがあります。

最大1件です。各タスクは、送信したURLが指す投稿を照会します。

投稿者の詳細、メディア、ハッシュタグ、メンション、エンゲージメント数が公開されていない、またはソースのレスポンスに含まれていない場合があります。

成功したタスク1件につき固定で0.19クレジットです。値が入っているフィールドの数には左右されません。