x/
user-replies

ユーザー名から、Xアカウントが書いた返信を新しい順に収集します。各返信には返信先のポストが付き、そのポストの本文、投稿者、リンク、日時が同じ行に入ります。

X User Replies API

ユーザー名を入力
アカウントが書いた返信
返信先のポスト付き
結果1件あたり0.7クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

X User Replies

X(旧Twitter)プロフィールの「返信」タブには、アカウントが他のポストに書いた返信が新しい順に並び、それぞれが会話と返信先のポストに結び付いていて、そのポストの投稿者と本文も確認できます。返信と返信先のポストを並べて見ると、アカウントが誰と話しているか、メインのタイムラインの外で何を言っているか、質問や批判にどう対応しているかがわかります。

X User Replies API の主な機能

  • 1つのアカウントが書いた返信ユーザー名を送信すると(先頭の @ は任意)、そのアカウントが投稿した返信を「返信」タブから読み取り、新しい順に返します。
  • 返信先のポストを同じ行にin_reply_to には各返信の返信先ポストの id、url、text、author、published_at が入るため、やり取りを結果からそのまま読めます。
  • 会話IDと親ポストのIDconversation_id と in_reply_to_id が各返信をスレッドと直前のポストに結び付けるため、返信を会話ごとにまとめられます。
  • 返信の本文、メディア、エンゲージメント各返信には本文、添付された画像や動画、いいね・コメント・シェア・表示回数が付きます。

X User Replies API のパラメータ

パラメータ必須説明
username必須返信を収集するXのユーザー名です。先頭の @ は付けても付けなくてもかまいません。
results_limit任意返す返信の件数です。1〜1,000の範囲で指定し、デフォルトは20です。

X User Replies API の使い方

ユーザー名を1つ送信し、その返信を返信先のポストとあわせて読み取ります。

  1. {"username": "elonmusk", "results_limit": 20} を /v1/x/user-replies に POST します。
  2. status が succeeded に変わるまで GET /v1/tasks/{task_id} をポーリングします。
  3. results.items から返信を読み取り(返信先のポストは in_reply_to に入ります)、has_more が true の間は results.next_cursor を渡します。
curl -X POST "https://api.socq.ai/v1/x/user-replies" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"elonmusk","results_limit":20}'

# in_reply_to holds the post each reply answers: its text, author, url and publish time.

X User Replies API の主なユースケース

  • アカウントの会話相手を把握: アカウントの返信全体で in_reply_to.author.username を集計し、最も頻繁にやり取りしている人やブランドを一覧にします。
  • ブランドのカスタマーサポート返信の監査: 各返信の text を in_reply_to.text と並べて読み、published_at から in_reply_to.published_at を引いて、サポートアカウントの返信の速さと質を測ります。
  • 著名人が返信で発言した内容の追跡: 経営者や政治家の返信を定期的に収集し、会話の中での発言を捉え、url を出典リンクとして残します。
  • 分析用のポストと返信のペア作成: in_reply_to.text と text を組み合わせてやり取りのデータセットを作り、アカウントの応じ方をトーン、スタンス、トピックの観点から分析します。

X User Replies API 活用のヒント

  • 返信は返信先アカウントのハンドルから始まるため、感情分析やテキスト長の計測の前に text 先頭の @ハンドルを取り除いてください。
  • 返信を conversation_id でまとめると、1つのスレッドでアカウントが残したすべてのメッセージを確認できます。
  • in_reply_to.text やその投稿者が空の場合も返信は残し、in_reply_to.url を保存しておくと、返信先のポストを後で調べられます。
  • 他の人がアカウントのポストにどんな返信をしたかを知りたいときは、ポストURLを指定して X Post Replies API を使ってください。X User Replies API が扱うのはアカウント自身が書いた返信です。

X User 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 Replies API — XのポストURLから公開返信を取得します。並び順を指定でき、返信テキスト、投稿者、表示中のエンゲージメント、メディア、親ポストの情報を返します。
  • X Thread Context API — ポストと、その返信チェーンをさかのぼった過去のメッセージ、公開返信、関連IDを取得します。

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

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

X User Replies API — よくある質問

X User Replies APIは、Xアカウントが書いた返信を、ユーザー名をもとにその「返信」タブから収集するためのプログラムインターフェースです。各返信の本文、エンゲージメント、メディア、会話IDを、in_reply_to に入った返信先のポストとあわせて返します。

その人のユーザー名を送信し、results_limit に必要な返信の件数を設定します。返信は新しい順に返り、has_more が true の間は next_cursor で続きを取得します。

X User Replies API は、1つのアカウントが書いた返信を、どこに投稿されたかにかかわらず返します。X Post Replies API は、送信したポストURLの下に他の人が残した返信を返します。

はい。in_reply_to にはそのポストの id、url、投稿日時が入り、ポストが公開されている場合は本文と投稿者も加わります。

1つのユーザー名につき1〜1,000件で、デフォルトは20件です。複数のアカウントを対象にする場合は、ユーザー名ごとにリクエストを送ってください。