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 の使い方
投稿のリンクを送信し、それぞれの投稿に付いた返信を読み取ります。
- {"urls": ["https://www.threads.com/@unrivaledbasketball/post/Dfa88pLDs_1"]} を /v1/threads/post-replies に POST し、task_id を控えます。
- GET /v1/tasks/{task_id} をポーリングします。status が succeeded になれば返信の準備は完了です。
- 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 で重複を除いてください。
関連API
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のプロフィールから、アカウントが最近投稿した公開返信を本文、エンゲージメント、メディア、リンクとともに取得します。