threads/
user-posts

対応する1つ以上のプロフィールURLから公開Threads投稿を取得し、投稿本文、投稿者情報、メディア、タイムスタンプ、表示中のエンゲージメントを正規化されたレコードで返します。

Threads User Posts API

プロフィールURLで指定
プロフィールごとの取得上限
正規化された公開投稿
結果1件あたり0.5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Threads User Posts

Threadsユーザーの投稿は、選定したプロフィールページから取得する公開投稿で、投稿本文、投稿者情報、メディア参照、投稿日時、表示中のエンゲージメント数を含みます。これらのレコードと取得時のタイムスタンプは、アカウントのコンテンツのアーカイブ、投稿形式の調査、公開エンゲージメントの比較に活用できます。

Threads User Posts API の主な機能

  • 上限付きのプロフィール単位の取得1つ以上の公開ThreadsプロフィールURLを受け付け、results_limit をプロフィールごとに個別に適用します。デフォルトは100で、1〜2,000の範囲で指定できます。
  • 正規化された投稿・投稿者・メディアのレコード投稿ID、元URL、本文、取得可能な投稿者情報、公開メディア参照を一貫した形式で返します。
  • エンゲージメントと取得元の情報表示中のいいね数・コメント数・再投稿数・シェア数を、投稿日時、collected_at、およびソースレコードに含まれる場合は送信したプロフィールの情報とあわせて保持します。

Threads User Posts API のパラメータ

パラメータ必須説明
urls必須必須。threads.com または threads.net 上の公開ThreadsプロフィールURLのリストです。各パスは /@username 形式である必要があり、ユーザー名のみ、投稿URL、無関係なパスは拒否されます。
results_limit任意プロフィールURLごとに取得する投稿の最大件数です。デフォルトは100で、1〜2,000の整数を指定できます。

Threads User Posts API の使い方

公開ThreadsプロフィールURLをプロフィールごとの取得上限とともに送信し、非同期タスクを追跡して、正規化された投稿をカーソルページネーションで読み取ります。

  1. threads.com または threads.net の /@username パスを使った公開ThreadsプロフィールURLを1つ以上用意します。
  2. urls と任意の results_limit を /v1/threads/user-posts に POST し、返された 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/user-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.threads.com/@example"],"results_limit":100}'

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

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

  • 選定プロフィールの投稿データセット: 指定した公開プロフィールについて、投稿ID、元URL、本文、投稿者フィールド、メディア参照、タイムスタンプ、送信したプロフィールの情報を保存します。
  • コンテンツと投稿形式の調査: 投稿本文、公開メディア参照、投稿者情報、投稿日時を使い、選定したプロフィール全体で繰り返し登場するテーマやコンテンツ形式を分析します。
  • 公開エンゲージメントの比較: collected_at で各取得時点を記録しながら、プロフィールごとに表示中のいいね数・コメント数・再投稿数・シェア数を比較します。

Threads User Posts API 活用のヒント

  • ユーザー名のみ、投稿リンク、無関係なパスでリクエストが失敗しないよう、送信前に各入力が threads.com または threads.net の /@username プロフィールURLであることを確認してください。
  • 上限はプロフィールごとに個別に適用されるため、取得件数と事前のクレジット見積もりは urls の数×results_limit で計画してください。
  • 後続のレコードで送信したプロフィールと取得時刻を追えるよう、各結果とともに discovery_input、input_url、collected_at を保存してください。
  • 本文、投稿者フィールド、メディア、created_at、個々の指標は任意項目として扱ってください。また、投稿の種別は公開されていないため、元投稿・返信・引用・再投稿のいずれかを推測しないでください。

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

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

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

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

Threads User Posts API — よくある質問

Threads User Posts APIは、対応する1つ以上のThreadsプロフィールURLから公開投稿レコードを取得します。正規化された投稿本文、投稿者情報、メディア、タイムスタンプ、表示中のエンゲージメント、送信したプロフィールの情報を返します。

threads.com、www.threads.com、threads.net、www.threads.net のいずれかで、パスが /@username の形式に従う HTTP または HTTPS のURLを送信してください。ユーザー名のみ、投稿URL、その他の形式のパスは拒否されます。

レコードには、投稿ID、URL、本文、公開されている投稿者情報、メディア参照、表示中のいいね数・コメント数・再投稿数・シェア数、created_at、collected_at、その他の取得元や入力の情報が含まれる場合があります。ソース側の任意項目は null または空になることがあります。

results_limit のデフォルトは100で、1〜2,000の整数を指定できます。上限はプロフィールURLごとに適用されるため、2つのURLに results_limit 50を指定すると最大100件の投稿をリクエストします。

正規化されたレスポンスには投稿の種別は含まれません。各アイテムは送信したプロフィールURLから取得した公開投稿として扱い、元投稿・返信・引用・再投稿のいずれかを推測しないでください。

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