X Post Replies
Xの返信は、ポストの会話内にある公開の反応で、本文、投稿者情報、言語、メディア、表示中のエンゲージメント、投稿日時、親ポストや関連ポストへのリンクを含みます。これらの会話レコードは、反応の分析、スレッドの再構築、返信のモニタリング、仕分け用データセットの準備に活用できます。
X Post Replies API の主な機能
- 既知のポストの会話を対象に取得1つ以上の公開XステータスURLを受け付けて各数値ポストIDを抽出し、送信した親ポスト自体を除いた返信を返します。
- 返信と投稿者のレコード保存された各返信について、返信ID、正規URL、本文、言語、投稿日時、正規化された公開投稿者情報を返します。
- 表示中の反応シグナル公開されているいいね数、返信数、リポスト数、引用数、表示回数、ブックマーク数を、メディア、ハッシュタグ、メンションとあわせて保持します。
- 選択可能なタイムラインの並び順送信したすべてのポストに relevance、latest、likes のいずれかの並び順を指定でき、会話ごとに個別の取得上限が適用されます。
- 会話の追跡送信URL、親ポストID、会話ID、返信先、ソース、引用、リポスト、返信制限のシグナルを正規化されたコンテキストに保持します。
X Post Replies API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
urls | 必須 | 必須。公開x.comまたはtwitter.comのポストURLの配列です。各パスに /status/{numeric_id} が含まれている必要があります。www、m、mobile のホスト形式も受け付けます。 |
results_limit | 任意 | 親ポストごとにリクエストする返信の最大数です。デフォルトは100で、20から2000までの20の倍数を指定できます。 |
sort_by | 任意 | 送信したすべてのポストに適用される返信タイムラインの並び順です。relevance、latest、likes のいずれかを指定します。デフォルトは relevance です。 |
X Post Replies API の使い方
既知の公開ポストURLを非同期タスクとして送信し、完了したタスクから正規化された返信レコードを読み取ります。
- 数値の /status/{id} を含む公開x.comまたはtwitter.comのURLを1つ以上用意し、relevance、latest、likes のいずれかの並び順を選びます。
- urls、ポストごとの results_limit(20から2000まで20単位)、sort_by を /v1/x/post-replies に POST します。
- 返された task_id を保存し、タスクが queued、running、retrying の間は GET /v1/tasks/{task_id} をポーリングします。
- 成功したら data.results.items を読み取り、data.results.has_more が true の間は cursor=data.results.next_cursor を付けて同じタスクをリクエストします。
curl -X POST "https://api.socq.ai/v1/x/post-replies" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://x.com/OpenAI/status/1950240351547248941"],"results_limit":100,"sort_by":"relevance"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and pass data.results.next_cursor as cursor while has_more is trueX Post Replies API の主なユースケース
- 公開の反応の分析: 選定した親ポスト間で返信本文、言語、投稿者、表示中のエンゲージメントを比較し、公開の会話がどう異なるかを分析します。
- 会話スレッドの再構築: parent_post_id、conversation_id、in_reply_to フィールド、返信ID、正規URLを使い、保存した返信を表示中のスレッドの文脈と結び付け直します。
- 取得の実行をまたいだ返信のモニタリング: 固定のポストURLセットについて、定期的なスナップショットごとに返信の投稿日時、collected_at、投稿者、公開されている各種カウントを追跡します。
- 手動仕分け用データセットの準備: 返信本文、投稿者情報、タイムスタンプ、URL、表示中のエンゲージメントを組み合わせ、後続のレビューキュー向けに反応レコードを準備します。
X Post Replies API 活用のヒント
- プロフィールや検索のリンクでタスクが失敗しないよう、送信前にすべてのURLが受け付け可能なXまたはTwitterのホストと数値の /status/ IDを持つことを検証してください。
- 異なるURL文字列が同じ親ポストを指すことがあるため、x.com と twitter.com の各URL形式から数値のステータスIDを抽出して重複を排除してください。
- results_limit は親ポストごとに20単位で設定します。会話の終端やタスク単位の重複排除が適用される前の候補総数は、urls × results_limit 件に近づくことがあります。
- sort_by は取得の目的に合わせて選びますが、relevance、latest、likes の各モード間で順位を共通のランキングスコアとして比較しないでください。
- 多数の親ポストの会話を再構築する場合、保存された1件の返信には送信URLと親ポストの情報が1つしか残らないため、タスク単位の返信の重複排除を考慮してください。
- 件数の少ない結果や空の結果は公開範囲による結果として扱い、投稿者、メディア、指標、関係のフィールドは仮の値を作らずに null のまま保存してください。
関連API
X Post Replies API 以外に別の種類の公開Xデータが必要な場合は、これらのAPIをご利用ください。
- Twitter Tweet Scraper API — x.comまたはtwitter.comのステータスURLから、公開ポストのテキスト、投稿者、エンゲージメント、メディア、ハッシュタグ、メンション、会話の関係を取得します。
- Twitter Profile Scraper API — ユーザー名から、公開アカウントの情報、プロフィール文、アバター、カバー画像、アカウントの状態、表示中のオーディエンス統計を取得します。
- Twitter User Tweets Scraper API — ユーザー名から、返信を除く最近の公開ポストを、投稿者、メディア、ハッシュタグ、メンション、エンゲージメントとともに取得します。
- Twitter Search API — 検索式で公開ポストを探します。最新順または話題順の並び替えと、取得件数の上限を指定できます。
- X Post Quotes API — 既知のステータスURLについて公開引用ポストを取得し、コメント、投稿者、エンゲージメント、メディア、タイムスタンプ、元のポストの情報を返します。
- X User Replies API — アカウントが書いた返信を、返信先のポストとセットで取得します。
- X Followers List API
- X Following List API
- X Post Retweeters API
- X Trends API
- Twitter Mentions API
- Twitter User Search API
- X Community API
- X Community Posts API
- X Thread Context API
- X Account Location API
- X Verified Followers API
- X List Tweets API
- Twitter List Members API
- Twitter List Followers API
- X Community Members API
- X Community Moderators API
- X Communities Search API
- X Articles API
- X Spaces API
- Twitter Media Scraper API
- Twitter Follow Checker API
- Twitter Video Transcript API