x/
post-quotes

既知のXステータスURLに対する公開引用ポストを取得し、コメント、投稿者情報、メディア、タイムスタンプ、会話の文脈、表示中のエンゲージメント指標を返します。

X Post Quotes API

引用コメント
元ポストの情報
ポストごとの上限
結果1件あたり0.5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

X Post Quotes

X Post Quotes APIは、指定したXポストに対する公開引用ポストを取得し、投稿者情報、引用コメント、メディア、投稿日時、表示中のエンゲージメントデータを、意見の追跡、感情分析、拡散効果の評価に使える形で返します。

X Post Quotes API の主な機能

  • 引用ポストへの展開1つ以上の公開ステータスURLを起点に、返信や単純なリポストのプロフィールではなく、それらの元ポストを引用した公開ポストを取得します。
  • 元ポストごとの個別上限元ポスト1件あたり20から2,000件のレコードを20単位でリクエストでき、送信した各ステータスはそれぞれ独自の取得元カーソルで処理が進みます。
  • 正規化されたコメントレコード引用本文、言語、投稿者情報、投稿日時と取得時刻、メディア、エンティティ、表示中のエンゲージメントを、統一された形式で受け取れます。
  • 取得元の追跡と重複排除送信したURLと親ポストIDを extra に保持し、繰り返し現れる引用ポストIDはタスク全体で1回だけ保存されます。

X Post Quotes API のパラメータ

パラメータ必須説明
urls必須必須。公開x.comまたはtwitter.comのステータスURLです。サポートされるホスト形式で、/status/ の後に数値のポストIDが含まれている必要があります。
results_limit任意任意。送信した元ポストごとの最大件数です。デフォルトは100で、20から2,000までの20の倍数である必要があります。

X Post Quotes API の使い方

既知の公開ステータスURLを送信し、非同期タスクをポーリングして、正規化された引用ポストのレコードをページ単位で取得します。

  1. パスに /status/{numeric_id} を含む公開x.comまたはtwitter.comのURLを用意します。
  2. urls 配列を任意の results_limit とともに /v1/x/post-quotes に POST し、task_id を保存します。
  3. タスクが成功または失敗するまで /v1/tasks/{task_id} をポーリングします。
  4. data.results.items を読み取り、has_more が true の間は next_cursor を再利用します。この結果カーソルは取得元のページネーションとは別のものです。
X_POST_URL="https://x.com/OpenAI/status/1950240351547248941"

curl -X POST "https://api.socq.ai/v1/x/post-quotes" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"urls\":[\"${X_POST_URL}\"],\"results_limit\":100}"

# Poll GET /v1/tasks/{task_id}?limit=50
# Follow data.results.next_cursor while data.results.has_more is true

X Post Quotes API の主なユースケース

  • 追加されたコメントの分析: 製品ローンチ、告知、研究リンク、キャンペーンポストを引用した公開ユーザーが何をコメントしたかをまとめ、レビュー用データセットを作成します。
  • 拡散に貢献したアカウントの特定: 引用した投稿者と表示中のエンゲージメントを比較し、その切り口が大きな反響を生んだアカウントを見つけます。
  • 引用ポストのスナップショット保存: 指定した元ポストのリストについて、コメント、メディアの参照、タイムスタンプ、取得時点のカウントを保存します。

X Post Quotes API 活用のヒント

  • 送信前にホスト名と数値の /status/ IDを検証してください。プロフィール、検索、ステータス以外のリンクは拒否されます。
  • results_limit はタスク単位ではなく元ポスト単位で見積もってください。URL 2件を100で指定すると、最大200件と見積もられます。
  • 複数の送信元から同じ引用ポストIDにたどり着いた場合でも、保存されるタスク結果には1回しか現れません。
  • 削除済み、非公開、制限中、検索対象外のポストは含まれないことがあるため、指定した件数は網羅性の保証ではなく上限として扱ってください。
  • メディア、エンティティ、会話、エンゲージメントのフィールドは null になり得る前提で保存し、変化するカウントを比較する際は collected_at を使用してください。

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

  • Twitter Tweet Scraper API — x.comまたはtwitter.comのステータスURLから、公開ポストのテキスト、投稿者、エンゲージメント、メディア、ハッシュタグ、メンション、会話の関係を取得します。
  • Twitter User Tweets Scraper API — ユーザー名から、返信を除く最近の公開ポストを、投稿者、メディア、ハッシュタグ、メンション、エンゲージメントとともに取得します。
  • X Post Replies API — XのポストURLから公開返信を取得します。並び順を指定でき、返信テキスト、投稿者、表示中のエンゲージメント、メディア、親ポストの情報を返します。
  • X Post Retweeters API — 既知のXまたはTwitterのステータスURLをリポストしたアカウントについて、正規化された公開プロフィールをタスク単位で重複なく取得します。
  • Twitter Mentions API — 指定したアカウントをメンションしている公開ポストを取得します。
  • X Community Posts API — コミュニティで共有された公開ポストを、テキスト、投稿者、インタラクション数とともに取得します。

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

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

X Post Quotes API — よくある質問

X Post Quotes APIは、既知のXステータスURLを参照する公開引用ポストを取得するためのプログラムインターフェースです。正規化されたコメント、投稿者、エンゲージメント、メディア、タイムスタンプ、元ポストの情報を返します。

パスに /status/ と数値のポストIDを含む公開x.comまたはtwitter.comのリンクを、空でない urls 配列として指定してください。

取得対象は、各元ステータスに対して返される引用ポストです。返信や、元ポストをリポストしただけのアカウントは別のリソースで扱います。

送信した元URLごとにデフォルトは100で、20から2,000までの20の倍数を指定できます。取得可能な公開結果が指定した上限より少ない場合もあります。

取得元のページは元ポストごとにポストIDで重複排除され、保存時には同じ正規化引用ポストIDがタスク全体で1回だけ保存されます。

タスクでは送信したURL全体でリクエストした結果1件につき0.5クレジットが見積もられ、その後、一意に保存された結果1件につき0.5クレジットで精算され、事前に引き当てた未使用分のクレジットは返金されます。