threads/
user-replies

プロフィールURLから、Threadsアカウントが投稿した最新の公開返信を1アカウントあたり約25件取得し、本文、いいね・返信・リポスト数、メディア、日時、リンクを返します。

Threads User Replies API

プロフィールURLを入力
最新の返信を約25件
返信ごとのエンゲージメント
結果1件あたり0.5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Threads User Replies

Threadsのユーザーの返信とは、アカウントが他人のスレッドに残した応答のことで、それぞれに本文、タイムスタンプ、添付メディア、リンク、受け取ったいいね・返信・リポストの数が付いています。返信はメインの投稿より手早く気取らずに書かれるため、アカウントの口調、専門性、会話への向き合い方が表れ、クリエイターの見極め、広報担当者の発言の追跡、カスタマー対応の研究に役立ちます。

Threads User Replies API の主な機能

  • 投稿ではなく返信を取得https://www.threads.com/@reuters のようなプロフィールリンクから、そのアカウントがほかの人に返信した内容、つまり最新の公開返信を最大約25件返します。
  • 各返信の本文、メディア、リンクtext には書かれた内容、media には添付された画像や動画が入り、url でThreads上のスレッド内にあるその返信を開けます。
  • 各返信への反応metrics.likes_count、metrics.comments_count、metrics.shares_count が、各返信が集めたいいね、さらなる返信、リポストの数を示します。

Threads User Replies API のパラメータ

パラメータ必須説明
urls必須threads.com または threads.net の /@{username} 形式のThreadsプロフィールリンクです(例:https://www.threads.com/@reuters)。

Threads User Replies API の使い方

プロフィールのリンクを送信し、各アカウントの最近の返信を読み取ります。

  1. {"urls": ["https://www.threads.com/@reuters"]} を POST /v1/threads/user-replies に送り、task_id を控えます。
  2. タスクが成功するまで GET /v1/tasks/{task_id} をポーリングします。
  3. results.items から返信を読み取り、has_more が true の場合は results.next_cursor で次のページを読み込みます。
curl -X POST "https://api.socq.ai/v1/threads/user-replies" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.threads.com/@reuters"]}'

# 0.5 credits per reply returned.

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

  • 提携前のクリエイター確認: クリエイターの最近の返信の text を読み、作り込まれた投稿とは別に、口調、専門性、オーディエンスへの接し方を判断します。
  • 広報担当者の公開返信の追跡: 経営者や広報担当者の返信を定期的に集め、新しいものを published_at で記録して、会話の中で出た発言を把握します。
  • ブランドの顧客対応の検証: ブランドアカウントの返信について、published_at で見た頻度といいねを集めた返信を調べ、サポートやコミュニティ担当が公の場でどう応じているかを確かめます。

Threads User Replies API 活用のヒント

  • 投稿リンクではなくプロフィールリンクを使ってください。特定の投稿の下にほかの人が残した返信が必要な場合は、Threads Post Replies API を使います。
  • 各実行で返るのは1アカウントあたり最大約25件の最新の返信だけなので、長期の記録を残すには定期的に取得し、id で重複を除いてください。
  • metrics.comments_count はその返信自体が受け取った返信の数で、長い議論に発展したやり取りを見つける目印になります。
  • 返信が何に答えたものかを知りたいときは、行の url を開いてください。リンク先ではスレッドの中でその返信が表示されます。

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

  • Threads Posts API — 対応するThreadsの投稿URLから、公開投稿のテキスト、投稿者情報、メディア、タイムスタンプ、表示中のエンゲージメントを取得します。
  • Threads Profiles API — 対応するThreadsのプロフィールURLから、公開プロフィールのアカウント情報、プロフィール文、画像、Webサイト、表示中のアカウントのカウント、取得情報を取得します。
  • Threads User Posts API — ThreadsのプロフィールURLから公開投稿を探します。プロフィールごとの取得上限を指定でき、正規化されたコンテンツ、投稿者、メディア、タイムスタンプ、表示中のエンゲージメント、取得元の情報を返します。
  • Threads Post Replies API — 投稿URLから、Threads投稿に付いた返信を本文、投稿者、いいね数と返信数、メディア、返信先の投稿IDとともに取得します。
  • Threads Search API — キーワードやハッシュタグでThreadsを検索し、上位の投稿を本文、投稿者、いいね・返信・リポスト数、メディア、投稿日時とともに返します。
  • Threads User Reposts API — Threadsのプロフィールから、アカウントが最近リポストした投稿を、元の投稿者、本文、エンゲージメント、メディア付きの元の投稿として取得します。

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

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

Threads User Replies API — よくある質問

Threads User Replies APIは、プロフィールの URL を起点に、Threadsアカウントがほかのスレッドに投稿した返信を取得するためのプログラムインターフェースです。最新の公開返信を、本文、いいね・返信・リポスト数、メディア、投稿日時、リンクとともに返します。

Threads User Posts API はアカウント自身の投稿を、Threads Post Replies API は1つの投稿の下に付いた返信を返します。Threads User Replies API は、指定したアカウントがほかの人に返信した内容を返します。

各プロフィールについて、最新の公開返信が最大約25件返ります。

返された返信1件につき0.5クレジットで、最近の返信が25件あるプロフィールなら12.5クレジットです。