Truth Social User Posts
Truth Social User Postsは、既知の公開アカウントの投稿を取得します。各タスクはユーザー名または数値の user_id でアカウントを特定し、1回の取得リクエストを実行して、一貫した形式の投稿レコードを返します。
Truth Social User Posts API の主な機能
- 2種類のアカウント識別子公開ユーザー名または数字のみの user_id を使用できます。少なくとも1つの識別子が必要です。
- 1タスクにつき1バッチ各タスクはアカウント投稿の取得を1回行い、そのレスポンスで取得できる公開投稿を返します。ソース側の後続ページは取得しません。
- 正規化された投稿内容投稿ID、URL、本文、投稿者、投稿日時と取得日時、メディア、ハッシュタグ、メンションを固定のフィールドで受け取れます。
- 表示中のエンゲージメント取得可能ないいね数・コメント数・シェア数・閲覧数を保持し、取得できない値は null のまま保持します。
Truth Social User Posts API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
username | 必須(いずれか1つ以上) | 公開ユーザー名です。先頭に任意で @ を付け、その後にASCIIの英字、数字、ピリオド、アンダースコア、ハイフンを1〜64文字続けます。前後の空白やプロフィールURLは使用できません。 |
user_id | 必須(いずれか1つ以上) | 数字のみのアカウントIDです。username の代わりに指定するか、対応する username とあわせて送信できます。 |
trim | 任意 | 任意のブール値です。オプションを明示的に設定する必要がある場合は true または false を送信し、送信しない場合はこのフィールドを省略してください。 |
Truth Social User Posts API の使い方
ユーザー名または user_id を指定してタスクIDを保存し、タスクが成功したら投稿リストを読み取ります。
- 公開ユーザー名または数字のみの user_id を入力します。通常は、どちらか一方の識別子のみを指定してください。
- 入力内容を /v1/truth-social/user-posts に POST し、レスポンスの data.task_id を保存します。
- タスクが成功または失敗するまで GET /v1/tasks/{task_id} をポーリングします。
- 成功したら data.results.items を読み取ります。保存済みの結果で has_more が true の場合にのみ next_cursor をたどってください。
curl -X POST "https://api.socq.ai/v1/truth-social/user-posts" \
-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 User Posts API の主なユースケース
- アカウントのコンテンツのスナップショット: 現在取得可能な公開投稿を保存し、アーカイブ、確認作業、定期的な比較に活用します。
- コンテンツ分析: 一貫した本文、投稿者、メディア、タイムスタンプのフィールドを使い、投稿を分類・検索・処理します。
- エンゲージメントの観測: 表示中のいいね数・コメント数・シェア数・閲覧数を、観測時刻である collected_at とあわせて比較します。
Truth Social User Posts API 活用のヒント
- 確認済みのユーザー名を優先してください。別のアカウント結果に数値の author.id が含まれている場合は、それを user_id として再利用できます。
- username や user_id にプロフィールURLを入れないでください。
- 両方の識別子を指定する場合は、両方の値がそのまま転送されるため、同じアカウントを指していることを確認してください。
- このエンドポイントは results_limit やソースのカーソルを受け付けません。各タスクでの取得は1回です。
- next_cursor は保存済みのタスク結果を順に読み進めるためのもので、ソースから追加の投稿を取得するものではありません。
関連API
Truth Social User Posts API 以外に別の種類の公開Truth Socialデータが必要な場合は、これらのAPIをご利用ください。
- Truth Social Post API — 既知のTruth Social投稿URL 1件から、正規化されたコンテンツ、投稿者情報、メディア、タイムスタンプ、取得可能な表示中のエンゲージメントの各フィールドを取得します。
- Truth Social Profile API — ユーザー名から公開Truth Socialプロフィール1件を取得し、正規化されたアカウント情報、プロフィール文、プロフィールメディア、アカウント属性、所在地、表示中のカウント、取得情報を返します。