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つ送信し、その返信を返信先のポストとあわせて読み取ります。
- {"username": "elonmusk", "results_limit": 20} を /v1/x/user-replies に POST します。
- status が succeeded に変わるまで GET /v1/tasks/{task_id} をポーリングします。
- 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 が扱うのはアカウント自身が書いた返信です。
関連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 Followers List API
- X Following List API
- X Post Quotes API
- X Post Retweeters API
- X Trends API
- Twitter Mentions API
- Twitter User Search API
- X Community API
- X Community Posts 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
- Twitter Follow Checker API
- Twitter Video Transcript API