x/
post-retweeters

既知のXまたはTwitterのポストをリポストしたアカウントについて、正規化された公開プロフィールを取得します。タスク単位の重複排除、表示中のアカウントシグナル、プロフィールの数値に対応しています。

X Post Retweeters API

リポストしたオーディエンス
公開プロフィール
タスク単位の重複排除
結果1件あたり0.5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

X Post Retweeters

X Post Retweetersのレコードは、既知のXまたはTwitterのステータスURLをリポストしたことが確認された公開アカウントを特定し、そのプロフィール情報、公開アカウントのシグナル、表示中の各種カウント、取得時刻を正規化したものです。複数の元ポストはそれぞれ独立してたどられ、保存されたプロフィールはタスク全体で重複排除されますが、各結果に元ポストとの対応は保持されません。

X Post Retweeters API の主な機能

  • ステータスURLの解決公開x.comおよびtwitter.comのステータスURLを受け付け、表示中のリポストユーザー一覧の取得に必要な数値のポストIDを解決します。
  • 正規化されたアカウントプロフィール取得可能な場合は、プロフィールID、ユーザー名、表示名、正規プロフィールURL、プロフィール文、アイコン画像、ヘッダー画像、公開アカウントのフラグを返します。
  • 表示中のプロフィール数値取得可能なフォロワー数・フォロー数・ポスト数・メディア数・いいね数を、アカウント作成日時と取得時のタイムスタンプとあわせて取得します。
  • 複数ポストの一意な結果セット送信した各ポストをそれぞれの取得上限でたどり、完了したタスク全体で各正規化プロフィールを1回だけ保存します。

X Post Retweeters API のパラメータ

パラメータ必須説明
urls必須必須。数値のポストIDを含む公開x.comまたはtwitter.comのステータスURLです。複数の値はカンマまたは改行で区切ります。
results_limit任意元ポストごとに個別にリクエストするプロフィールの最大数です。デフォルトは100で、100から2,000までの100の倍数を指定できます。

X Post Retweeters API の使い方

既知の公開ステータスURLを非同期タスクとして送信し、状態をポーリングしてから、一意な正規化プロフィールの結果をページ単位で取得します。

  1. パスに /status/{numeric_post_id} を含む公開x.comまたはtwitter.comのURLを1つ以上用意します。
  2. urls を、100から2,000までの100単位の results_limit とともに POST します。
  3. status が succeeded または failed になるまで /v1/tasks/{task_id} をポーリングします。
  4. /v1/tasks/{task_id}?limit=50 を読み取り、results.has_more が true の間は results.next_cursor を渡します。
curl -X POST "https://api.socq.ai/v1/x/post-retweeters" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://x.com/OpenAI/status/1950240351547248941"],"results_limit":100}'

# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50 and follow data.results.next_cursor

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

  • 拡散したオーディエンスの発見: 選定したポストを拡散したことが確認された公開アカウントの一意なディレクトリを作成し、調査、レビュー、アウトリーチの準備に活用します。
  • リポストユーザーのプロフィール補完: 拡散データセットに、正規プロフィール、プロフィール文、画像、公開アカウントのフラグ、所在地、ウェブサイト、表示中の指標を追加します。
  • ポスト間のオーディエンス重複の分析: ポストごとの重複や対応関係が重要な場合は、1タスクにつき1つの元ポストを実行し、完了した結果セット間で固定のプロフィールIDを比較します。

X Post Retweeters API 活用のヒント

  • 同じポストを指す異なるURL形式が入力検証の段階でまとめられるとは限らないため、一括送信の前にステータスURLを正規化し、数値のポストIDで重複を排除してください。
  • results_limit は元ポストごとの上限であり、保証される結果数ではありません。公開範囲や利用可能なページネーションによって、プロフィールが少なくなることがあります。
  • 正規化されたプロフィール結果には元のポストURLやポストIDが保持されないため、取得元との対応が重要な場合は1タスクにつき1つの元URLを使用してください。
  • 不透明なタスクの results.next_cursor は、取得時のページネーションとは独立してたどってください。公開カーソルは、すでに保存された正規化結果をページ送りするものです。
  • タスクをまたいでマージする際はプロフィールIDを永続的なキーとして使い、変化する公開カウントは collected_at を基準にしてください。
  • 公開プロフィール文、画像、アカウントのシグナル、各種カウント、リポストユーザーの表示が利用できない場合があるため、プロフィールフィールドの null や空の結果を許容してください。

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

  • Twitter Tweet Scraper API — x.comまたはtwitter.comのステータスURLから、公開ポストのテキスト、投稿者、エンゲージメント、メディア、ハッシュタグ、メンション、会話の関係を取得します。
  • Twitter Profile Scraper API — ユーザー名から、公開アカウントの情報、プロフィール文、アバター、カバー画像、アカウントの状態、表示中のオーディエンス統計を取得します。
  • X Followers List API — 1つ以上のXユーザー名について、公開フォロワーのアカウント情報と表示中のプロフィール指標を取得します。
  • X Following List API — 公開Xアカウントがフォローしているプロフィールを、アカウント情報、プロフィール文、アカウントシグナル、表示中のカウント、元のユーザー名とともに取得します。
  • X Post Quotes API — 既知のステータスURLについて公開引用ポストを取得し、コメント、投稿者、エンゲージメント、メディア、タイムスタンプ、元のポストの情報を返します。
  • X Community API — コミュニティのリンクから、説明、メンバー数、ルール、参加ポリシーを取得します。

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

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

X Post Retweeters API — よくある質問

X Post Retweeters APIは、1つ以上の既知のXまたはTwitterのポストをリポストしたことが確認されたアカウントについて、正規化された公開プロフィールレコードを取得するAPIです。

x.com、www.x.com、m.x.com、mobile.x.com、twitter.com、www.twitter.com、m.twitter.com、mobile.twitter.com 上の、パスに /status/{numeric_post_id} を含む http または https のURLを送信してください。

上限は元ポストごとに個別に適用されます。デフォルトは100で、100から2,000までの100の倍数である必要があります。

結果には、プロフィールID、ユーザー名、名前、正規URL、プロフィール文、アイコン画像、ヘッダー画像、認証と非公開のシグナル、表示中の指標、アカウント作成日時、取得時刻、その他の公開アカウントのシグナルが含まれる場合があります。

いいえ。結果は確認されたリポストユーザーの正規化プロフィールレコードであり、リポストのオブジェクト、追加されたコメント、引用ポストの内容は含まれません。

いいえ。プロフィールはタスク全体で重複排除され、正規化レコードには元ポストのURLやIDが保持されません。その対応関係が必要な場合は、1タスクにつき1つのポストを送信してください。

results_limit は上限です。ポストの表示中のリポストユーザーが少ない、取得時のページネーションが終わる、利用できないアカウントが含まれない、同じプロフィールがタスク全体で1回しか保存されない、といった理由が考えられます。

最終的な利用料金は一意に保存されたプロフィール1件につき0.5クレジットで、基本料金はありません。事前引き当ての見積もりには送信したURL数とポストごとの results_limit が使われ、結果が空の場合は0クレジットです。