Threads User Reposts
Threadsのユーザーのリポストとは、アカウントがフォロワーにあらためて共有すると決めた投稿のことで、どれも元の投稿として、作成者、本文、メディア、投稿日時、集まったいいね・返信・リポストの数を持っています。リポストは意図的な支持の表明なので、一覧からはアカウントが誰の声を広めているか、ブランドがどのパートナーを後押ししているか、どのコンテンツがコミュニティ内を広がっているかが見えてきます。
Threads User Reposts API の主な機能
- 各リポストの元の投稿すべての行はリポストされた投稿そのもので、author には元の作成者が入るため、アカウントが誰のコンテンツを広めたかを正確に把握できます。
- 元の投稿のエンゲージメントmetrics.likes_count、metrics.comments_count、metrics.shares_count は元の投稿のいいね・返信・リポストの数で、広められたコンテンツがすでにどれだけ反響を得ていたかを示します。
- プロフィールリンクから最近のリポストurls には https://www.threads.com/@shams のようなプロフィールリンクを指定し、各プロフィールが最近リポストした投稿を最大約25件返します。
Threads User Reposts API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
urls | 必須 | threads.com または threads.net の /@{username} 形式のThreadsプロフィールリンクです(例:https://www.threads.com/@shams)。 |
Threads User Reposts API の使い方
プロフィールのリンクを送信し、そのアカウントがリポストした投稿を読み取ります。
- {"urls": ["https://www.threads.com/@shams"]} を /v1/threads/user-reposts に POST し、task_id を保存します。
- status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
- results.items からリポストされた投稿を読み取り、has_more が true の間は results.next_cursor をたどります。
curl -X POST "https://api.socq.ai/v1/threads/user-reposts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.threads.com/@shams"]}'
# 0.5 credits per reposted post returned.Threads User Reposts API の主なユースケース
- アカウントが広めている発信者の把握: プロフィールのリポスト全体で author.username の出現回数を数え、もっとも頻繁に共有しているクリエイターやメディアを順位付けします。
- ブランドが後押しするパートナーの発見: ブランドのリポストに含まれる元の投稿者と text を確認し、ブランドが後押しを選んだコラボ相手、アンバサダー、メディアを見つけます。
- コミュニティに広がるコンテンツの追跡: 同じジャンルの複数のアカウントからリポストを集め、そのうち何人もが共有した投稿の id を見つけます。
Threads User Reposts API 活用のヒント
- どの行の author も元の作成者なので、各リポストをどのアカウントが行ったかを知る必要がある場合は、1タスクにつき1プロフィールを送信してください。
- published_at は元の投稿の日時として扱ってください。リポストが現れた時期を記録するには、定期的に取得して各 id が最初に現れた時点を残します。
- アカウントが広めることを選んだ投稿の下の会話を読むには、行の url を Threads Post Replies API に送ってください。
関連API
Threads User Reposts 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 Replies API — Threadsのプロフィールから、アカウントが最近投稿した公開返信を本文、エンゲージメント、メディア、リンクとともに取得します。