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を非同期タスクとして送信し、状態をポーリングしてから、一意な正規化プロフィールの結果をページ単位で取得します。
- パスに /status/{numeric_post_id} を含む公開x.comまたはtwitter.comのURLを1つ以上用意します。
- urls を、100から2,000までの100単位の results_limit とともに POST します。
- status が succeeded または failed になるまで /v1/tasks/{task_id} をポーリングします。
- /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_cursorX 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 や空の結果を許容してください。
関連API
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 — コミュニティのリンクから、説明、メンバー数、ルール、参加ポリシーを取得します。
- Twitter User Tweets Scraper API
- Twitter Search API
- X Post Replies API
- X Trends API
- Twitter Mentions API
- Twitter User Search 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
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API