threads/
post-replies

投稿URLからThreads投稿に付いた返信を取得し、返信の本文、投稿者と認証バッジ、いいね数と返信数、メディア、日時、返信先の投稿IDを返します。

Threads Post Replies API

投稿URLを入力
1投稿あたり約20件の返信
いいね数と返信数
投稿者の認証フラグ
結果1件あたり0.3クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Threads Post Replies

Threadsの投稿への返信は投稿の下にできる会話で、各返信に本文、書いたアカウント、画像や動画、タイムスタンプ、集まったいいねとさらなる返信の数が付いています。まとめて読むと、告知に対してオーディエンスが実際にどう反応したか、どんな質問や不満が出たか、どの声がもっとも共感を集めたかがわかります。

Threads Post Replies API の主な機能

  • 投稿リンクからそのまま返信を取得urls に threads.com または threads.net の /@{username}/post/{code} 形式のリンクを1つ以上渡すと、各投稿の下にThreadsが表示する返信が1投稿あたり約20件返ります。
  • 返信ごとのエンゲージメントmetrics.likes_count は返信が得た共感の量、metrics.replies_count はその返信が生んだ追加の議論の量を示します。
  • 認証状態付きの返信者情報author は返信者のユーザー名、表示名、プロフィールの url、アバターを返し、is_verified で認証バッジの有無を見分けられます。
  • 返信先の投稿との結び付きpost_id は各返信が属する投稿を示し、url は返信そのものを開くため、複数の投稿を混ぜたバッチでも分けて確認しやすくなります。

Threads Post Replies API のパラメータ

パラメータ必須説明
urls必須threads.com または threads.net の /@{username}/post/{code} 形式のThreads投稿リンクです(例:https://www.threads.com/@unrivaledbasketball/post/Dfa88pLDs_1)。

Threads Post Replies API の使い方

投稿のリンクを送信し、それぞれの投稿に付いた返信を読み取ります。

  1. {"urls": ["https://www.threads.com/@unrivaledbasketball/post/Dfa88pLDs_1"]} を /v1/threads/post-replies に POST し、task_id を控えます。
  2. GET /v1/tasks/{task_id} をポーリングします。status が succeeded になれば返信の準備は完了です。
  3. results.items から返信を読み取り、has_more が true の場合は results.next_cursor で続けます。
curl -X POST "https://api.socq.ai/v1/threads/post-replies" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.threads.com/@unrivaledbasketball/post/Dfa88pLDs_1"]}'

# 0.3 credits per reply; posts without replies are free.

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

  • 告知への反応の把握: 新製品やニュースの投稿に付いた返信の text を読み、likes_count で重み付けして、オーディエンスが支持した反応を見極めます。
  • ブランド投稿からの顧客の声の収集: ブランドの投稿への返信を published_at とともに集め、届いた質問、不満、要望を順に記録します。
  • 熱心なオーディエンスの発見: クリエイターの投稿全体で各 author.username が返信した回数と、その返信が集めたいいね数を数え、声をかける価値のある常連を見つけます。
  • 投稿ごとの反響の比較: 複数の投稿をまとめて送り、返信を post_id でグループ化して、それぞれが集めた反応の量とトーンを比べます。

Threads Post Replies API 活用のヒント

  • 投稿そのもののリンクをコピーしてください。/@username のようなプロフィールのアドレスはここでは拒否されます。アカウント自身がほかの場所に書いた返信は Threads User Replies API で取得します。
  • 1投稿あたり約20件の返信、1件0.3クレジットでおよそ6クレジットを見込み、投稿数を掛けてバッチの予算を立ててください。
  • Threadsが表示する返信は実行ごとに重なることがあるため、同じ投稿を後で再取得するときは id で重複を除いてください。

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

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

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

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

Threads Post Replies API — よくある質問

Threads Post Replies APIは、投稿の URL から、公開Threads投稿に付いた返信を読み取るためのプログラムインターフェースです。各返信の本文、認証状態付きの投稿者、いいね数と返信数、メディア、投稿日時、返信先の投稿IDを返します。

/@{username}/post/{code} 形式の投稿自身のリンクを使ってください。threads.com と threads.net のどちらのアドレスも使えます。

各投稿の下にThreadsが表示する返信が約20件返るので、リクエストには投稿のリンクを渡すだけで済みます。

すべての投稿リンクを urls に追加してください。各返信には post_id が付き、どの投稿の返信かがわかります。

返された返信1件につき0.3クレジットで、返信が約20件ある投稿ならおよそ6クレジットです。