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を保存し、完了後に投稿の詳細を読み取ります。
- デフォルトの公開投稿URLを使うか、取得したいTruth Social投稿の完全なリンクに置き換えます。
- url を /v1/truth-social/post に POST し、レスポンスの data.task_id を保存します。
- タスクが成功または失敗するまで GET /v1/tasks/{task_id} をポーリングします。
- 成功したら、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 successTruth Social Post API の主なユースケース
- 投稿リンクの情報補完: 既知の投稿リンクを、検索可能な本文、投稿者、タイムスタンプ、出典のフィールドに変換します。
- 選定したコンテンツの確認: レビューワークフローの中で、特定の公開投稿の本文、投稿者、添付ファイルを取得します。
- エンゲージメントの変化の追跡: 定期的に照会を繰り返し、公開エンゲージメントを collected_at とあわせて比較します。
Truth Social Post API 活用のヒント
- プロフィール、検索ページ、その他のTruth Socialページではなく、実際の投稿の完全なURLを送信してください。
- URLには http または https を含め、truthsocial.com またはそのサブドメインを使用する必要があります。
- URLの検証を通過しても、投稿が存在すること、または公開アクセス可能な状態であることは保証されません。
- 投稿者の詳細、メディア、ハッシュタグ、メンション、エンゲージメントデータは null になり得るフィールドとして扱ってください。
- このエンドポイントは results_limit やソースのカーソルを受け付けず、1タスクにつき最大1件の投稿レコードを返します。
関連API
Truth Social Post API 以外に別の種類の公開Truth Socialデータが必要な場合は、これらのAPIをご利用ください。
- Truth Social Profile API — ユーザー名から公開Truth Socialプロフィール1件を取得し、正規化されたアカウント情報、プロフィール文、プロフィールメディア、アカウント属性、所在地、表示中のカウント、取得情報を返します。
- Truth Social User Posts API — ユーザー名または数値のアカウントIDから、公開Truth Social投稿を取得元の1ページ分取得し、正規化されたコンテンツ、投稿者、メディア、タイムスタンプ、表示中のエンゲージメントを返します。