Truth Social API
公開アカウントの詳細の取得、アカウントの投稿の取得元1ページ分の取得、既知の投稿URL 1件の解決ができ、正規化レコードとして返します。
利用できるTruth Social API
ユーザー名1件にはProfile、ユーザー名または数値のアカウントIDにはUser Posts、既知の truthsocial.com の投稿URL 1件にはPostを使用します。
取得できるTruth Socialデータ
結果には安定したアカウントと投稿のスキーマを使用し、取得元に依存するフィールドは null になる場合があります。
プロフィール情報
取得可能なユーザー名、表示名、プロフィール文、プロフィールのメディア、Webサイト、アカウントのフラグ、所在地、表示中の数値を取得します。
投稿のコンテンツ
正規化された投稿ID、公開URL、本文、投稿者のコンテキスト、公開日時、取得日時を取得します。
メディアとエンゲージメント
取得可能な添付ファイル、ハッシュタグ、メンション、表示中のいいね数・コメント数・シェア数・表示回数を利用できます。
Truth Social APIの選び方
各エンドポイントは取得元の入力範囲が限定されており、共通の非同期タスクワークフローを使用します。
| エンドポイント | 入力 | 取得元の範囲 |
|---|---|---|
| Profile | ユーザー名1件 | 公開アカウント1件 |
| User Posts | ユーザー名または数値のユーザーID | 提供元のレスポンス1ページ分 |
| Post | truthsocial.com のURL 1件 | 公開投稿最大1件 |
Truth Socialのデータ取得の仕組み
送信と保存済み結果の取得は、別々のステージで行われます。
1. エンドポイントを選ぶ
既知の公開リソースに合わせて、Profile、User Posts、Postのいずれかを選択します。
2. タスクを追跡
task_id を保存し、成功または失敗するまで /v1/tasks/{task_id} をポーリングします。
3. 保存済みのレコードを読み取る
成功後に data.results.items を読み取り、保存済みの結果に次のページがある間だけ next_cursor をたどります。
有効な公開セレクターを指定し、SocQのAPIキーで認証します。
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"}'Truth Social APIの主な用途
公開アカウントの情報補完
既知の公開ユーザー名に、取得可能なアカウント情報、プロフィール文、画像、フラグ、数値を紐づけます。
アカウントの投稿スナップショット
選んだアカウントで公開されている投稿レコードを、取得日時とともに保存します。
既知の投稿の確認
公開投稿1件を、取得可能な投稿者、メディア、タイムスタンプ、表示中のエンゲージメントとともに正規化します。
対象範囲と制限
これらのエンドポイントは、取得時点で利用可能な公開データを読み取るもので、アカウント管理の操作は提供しません。
- Profileには、@を任意で付けられる形式のユーザー名が1つ必要です。
- User Postsには、username または数字のみの user_id が必要です。両方を指定した場合はどちらも転送されます。trim は任意のブール値です。
- Postには、解析後のホスト名が truthsocial.com またはそのサブドメインである、空でないURLが必要です。
- リクエストでは results_limit や提供元のカーソルは受け付けません。
- 結果のカーソルと limit は、SocQがすでに保存したレコードをページ分割するもので、取得元の別ページを取得するものではありません。
Truth Social APIのよくある質問
どのTruth Social APIを利用できますか?
Profileは公開アカウント1件を取得し、User Postsはユーザー名または数値のアカウントIDについて取得元の1ページ分を取得し、Postは既知の公開投稿URL 1件を解決します。
User Postsで username と user_id の両方を指定できますか?
はい。少なくとも一方が必要で、バックエンドは空でない値を両方とも転送します。どちらか一方が優先されることはありません。
next_cursor で取得元の投稿をさらに取得できますか?
いいえ。タスク成功後にすでに保存されたレコードを順に進めるためだけに使われます。
データ取得の料金はいくらですか?
成功したTruth Socialタスクには、1回あたり一律0.19 SocQクレジットが課金されます。
プラットフォームを横断してデータを組み合わせ、より包括的なビジネスインサイトを
さまざまなプラットフォームの公開プロフィール、コンテンツ、エンゲージメントデータを1つのワークフローに集約し、ブランド、クリエイター、トピックの追跡やクロスプラットフォームのモニタリング・分析をより効率的に行えます。
Google Ad Library API
公開広告主の検索、企業ごとのクリエイティブの取得、URLによる既知の透明性センターのクリエイティブ1件の取得ができ、調査やレビューに活用できます。
Google Maps API
公開スポットの検索、既知のMaps URLの正規化された詳細の取得、取得元に紐づくスポット情報と投稿者のコンテキストを含む公開クチコミの取得ができます。
Amazon API
対応するマーケットプレイスで公開Amazon商品を検索し、正規化された商品詳細、売れ筋ランキング、レビュー、セラーのプロフィール、クリエイターのストアフロントのレコードを取得できます。
Apple App Store API
既知のストアURLから、公開Apple App Storeのアプリ詳細、カテゴリランキング、レビューを、正規化されたアプリとレビューのレコードとして取得できます。
SEO API
Googleのオーガニック検索結果をリアルタイムで取得し、キーワードの需要と順位獲得の難易度を比較し、シードキーワードを拡張し、サイトの検索での可視性を支えるキーワードとページを明らかにし、検索意図を分類できるほか、Googleニュース・画像・サジェスト、Bing、YouTubeの結果も集められます。すべてのエンドポイントで、共通のSocQのAPIキー、非同期タスクフロー、正規化された結果形式を使用します。
Telegram API
t.meリンクから公開Telegramチャンネルを読み取ります。登録者数付きのチャンネル情報、閲覧数とリアクション付きの投稿、個別の投稿、ディスカッショングループのコメント、類似チャンネル、全履歴の検索に対応します。


