x/
post-replies

1つ以上のXポストURLから公開返信を取得し、返信本文、投稿者、表示中のエンゲージメント、メディア、親ポストの情報を返します。ポストごとの上限と並び順を指定できます。

X Post Replies API

ポストの会話
返信の並び順
親ポストの情報
結果1件あたり0.5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

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を非同期タスクとして送信し、完了したタスクから正規化された返信レコードを読み取ります。

  1. 数値の /status/{id} を含む公開x.comまたはtwitter.comのURLを1つ以上用意し、relevance、latest、likes のいずれかの並び順を選びます。
  2. urls、ポストごとの results_limit(20から2000まで20単位)、sort_by を /v1/x/post-replies に POST します。
  3. 返された task_id を保存し、タスクが queued、running、retrying の間は GET /v1/tasks/{task_id} をポーリングします。
  4. 成功したら 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 true

X 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 のまま保存してください。

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のデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

X Post Replies API — よくある質問

X Post Replies APIは、数値のステータスIDを含む1つ以上のXポストURLから公開返信を取得するためのプログラムインターフェースです。返信本文、投稿者、表示中のエンゲージメント、メディア、タイムスタンプ、親の会話の情報を返します。

パスに /status/{numeric_id} を含む公開x.comまたはtwitter.comのポストリンクを、空でない urls 配列として送信してください。標準、www、m、mobile のホスト形式を受け付けます。

results_limit のデフォルトは100で、20から2000までの20の倍数を指定でき、親ポストごとに個別に適用されます。会話が指定した上限に達する前に終わることもあります。

sort_by は、送信したすべてのポストに対して対応する公開返信タイムラインのモードを選択します。デフォルトは relevance です。返される順序は選択した取得モードによるものであり、SocQ独自のランキングスコアではありません。

返信には、ID、URL、本文、言語、公開投稿者、表示中のカウント、メディア、ハッシュタグ、メンション、投稿日時と取得時刻に加え、extra 内の会話と親ポストのフィールドが含まれる場合があります。

送信した親ポストは、その返信結果から除外されます。返信IDは取得時とタスク結果の保存時の両方で重複排除されるため、繰り返し現れた返信は1件のレコードにまとめられることがあります。

非表示、削除済み、非公開、制限中、利用不可、またはつながりの切れた返信ツリーは公開で表示されないことがあります。また、表示中の会話が終わった時点や、ポストごとの指定上限に達した時点で取得は停止します。

できません。このエンドポイントは、選択した会話内の返信ポストを返します。引用ポストや、ポストをリポストしたプロフィールは別のXリソースです。

保存された正規化返信1件につき0.5クレジットです。請求は実際に保存されたレコード数に基づくため、結果が空の場合は結果単位の課金は発生しません。