truth-social/
user-posts

公開ユーザー名または数値の user_id を入力して、アカウントの取得可能な投稿を、正規化された本文、投稿者、メディア、タイムスタンプ、エンゲージメントデータとともに取得できます。

Truth Social User Posts API

ユーザー名または user_id
公開アカウントの投稿
1タスクあたり0.19クレジット
1リクエストあたり0.19クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

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を保存し、タスクが成功したら投稿リストを読み取ります。

  1. 公開ユーザー名または数字のみの user_id を入力します。通常は、どちらか一方の識別子のみを指定してください。
  2. 入力内容を /v1/truth-social/user-posts に POST し、レスポンスの data.task_id を保存します。
  3. タスクが成功または失敗するまで GET /v1/tasks/{task_id} をポーリングします。
  4. 成功したら 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 success

Truth Social User Posts API の主なユースケース

  • アカウントのコンテンツのスナップショット: 現在取得可能な公開投稿を保存し、アーカイブ、確認作業、定期的な比較に活用します。
  • コンテンツ分析: 一貫した本文、投稿者、メディア、タイムスタンプのフィールドを使い、投稿を分類・検索・処理します。
  • エンゲージメントの観測: 表示中のいいね数・コメント数・シェア数・閲覧数を、観測時刻である collected_at とあわせて比較します。

Truth Social User Posts API 活用のヒント

  • 確認済みのユーザー名を優先してください。別のアカウント結果に数値の author.id が含まれている場合は、それを user_id として再利用できます。
  • username や user_id にプロフィールURLを入れないでください。
  • 両方の識別子を指定する場合は、両方の値がそのまま転送されるため、同じアカウントを指していることを確認してください。
  • このエンドポイントは results_limit やソースのカーソルを受け付けません。各タスクでの取得は1回です。
  • next_cursor は保存済みのタスク結果を順に読み進めるためのもので、ソースから追加の投稿を取得するものではありません。

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

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

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

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

Truth Social User Posts API — よくある質問

Truth Social User Posts APIは、ユーザー名または数値の user_id で公開アカウントの投稿を取得し、正規化された本文、投稿者、メディア、タイムスタンプ、表示中のエンゲージメントデータを返します。

少なくとも一方が必要です。通常は username を使用し、アカウントの数値IDがすでにわかっている場合は user_id を使用してください。

できます。ただし、両方の値が取得処理にそのまま転送されるため、同じアカウントを指している必要があります。

trim は任意のブール値です。true または false を明示的に選ぶ必要がある場合にのみ設定し、それ以外の場合は省略できます。

できません。各タスクでのソースからの取得は1回です。next_cursor は、そのタスクで保存済みのレコードをページ送りするためだけに使用します。

成功したタスク1件につき固定で0.19クレジットです。返される投稿の件数には左右されません。