threads/
posts

対応する投稿URLから公開Threads投稿を取得し、本文、投稿者情報、メディア、投稿日時、表示中のエンゲージメントを正規化されたレコードで返します。

Threads Posts API

投稿URLで指定
投稿者情報
エンゲージメントのスナップショット
結果1件あたり0.5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Threads Posts

Threadsの投稿は、投稿者情報、メディア参照、投稿日時、表示中のいいね数・コメント数・再投稿数・シェア数を持つ、テキスト中心の公開投稿です。これらのレコードは、選定した投稿の調査、出典の確認、コンテンツ比較、タイムスタンプ付きのエンゲージメント分析に活用できます。

Threads Posts API の主な機能

  • 投稿URLから直接取得threads.com または threads.net の公開 /@username/post/{post_id} URLを照会し、プロフィールのフィードではなく、送信した投稿そのもののレコードを返します。
  • 投稿内容と投稿者の紐づけ投稿ID、元URL、本文に加え、取得可能な投稿者ID、ユーザー名、表示名、プロフィールURLを返し、追跡可能なレコードにします。
  • メディアと表示中のエンゲージメント正規化されたメディア参照、投稿日時と取得日時、表示中のいいね数・コメント数・再投稿数・シェア数を投稿ごとにまとめて保持します。

Threads Posts API のパラメータ

パラメータ必須説明
urls必須必須。threads.com または threads.net 上の、/@username/post/{post_id} パスを使った公開Threads投稿URLのリストです。

Threads Posts API の使い方

取得したい既知の公開Threads投稿を送信し、非同期タスクを追跡して、正規化された結果をカーソルページネーションで読み取ります。

  1. threads.com または threads.net の /@username/post/{post_id} パスを使った公開Threads投稿URLを1つ以上用意します。
  2. リンクを urls として /v1/threads/posts に送信し、返された task_id を保存します。
  3. タスクが成功するか失敗を返すまで /v1/tasks/{task_id} をポーリングします。
  4. data.results.items を読み取り、has_more が true の間は返された next_cursor を指定して続きをリクエストします。
curl -X POST "https://api.socq.ai/v1/threads/posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.threads.com/@example/post/POST_ID"]}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Threads Posts API の主なユースケース

  • 選定した投稿リストの情報補完: 既知の投稿URLを、ID、本文、投稿者フィールド、メディア、タイムスタンプ、元リンクを含むレコードに変換し、目的に合ったデータセットを作成します。
  • 公開コンテンツと出典の確認: 本文、メディア参照、投稿者情報、元URLを使い、公開ソースを保持したまま選定した投稿を確認します。
  • エンゲージメントのスナップショット比較: likes_count、comments_count、reposts_count、shares_count を collected_at と組み合わせ、異なる時点で取得した値を比較します。

Threads Posts API 活用のヒント

  • プロフィールページや無関係なThreadsのパスでリクエストが失敗しないよう、送信前に各URLが /@username/post/{post_id} パスに一致するか確認してください。
  • 対応する別のホスト名によって同じ投稿が重複処理されないよう、バッチにまとめる前に投稿パス単位でリンクの重複を排除してください。
  • このエンドポイントは既知の投稿URL専用です。プロフィールのフィード取得や投稿から返信への展開は行わないため、results_limit は指定しないでください。
  • 一部の情報しか公開されていない投稿でも結果処理が止まらないよう、本文、投稿者フィールド、メディア、投稿日時、個々の指標は任意項目として扱ってください。
  • 各スナップショットをいつ取得したかを残すため、表示中のエンゲージメントフィールドとあわせて collected_at を保存してください。

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

  • 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のプロフィールから、アカウントが最近投稿した公開返信を本文、エンゲージメント、メディア、リンクとともに取得します。
  • Threads User Reposts API — Threadsのプロフィールから、アカウントが最近リポストした投稿を、元の投稿者、本文、エンゲージメント、メディア付きの元の投稿として取得します。

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

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

Threads Posts API — よくある質問

Threads Posts APIは、対応する公開Threads投稿URLを照会し、本文、投稿者情報、メディア、投稿日時、表示中のいいね数・コメント数・再投稿数・シェア数を含む正規化レコードを返します。

threads.com、www.threads.com、threads.net、www.threads.net のいずれかで、パスが /@username/post/{post_id} の形式に従う http または https のURLを送信してください。プロフィールページやその他の形式のパスは拒否されます。

できません。各入力は件数を制限するフィードではなく特定の公開投稿を指すため、投稿指定のペイロードは results_limit を含まず urls を使用します。

含まれません。投稿レコードには表示中の comments_count が含まれる場合がありますが、返信の本文、返信者、返信ツリーは含まれません。

公開ソースのレコードが利用可能な値を公開していない場合、本文、投稿者の詳細、メディア、投稿日時、個々のエンゲージメント値が空になることがあります。

返された投稿レコード1件につき0.5 SocQクレジットです。結果が空の場合、結果に対する課金は発生しません。