threads/
profiles

対応するプロフィールURLから公開Threadsプロフィールを取得し、正規化されたアカウント情報、プロフィール文、プロフィール画像、Webサイト、表示中のアカウント指標を返します。

Threads Profiles API

プロフィールURLで指定
アカウント情報とWebサイト
表示中のアカウント指標
結果1件あたり0.6クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Threads Profiles

Threadsプロフィールは、ユーザー名、表示名、プロフィール文、プロフィール画像、Webサイト、表示中のフォロワー数・フォロー数・投稿数を含む公開アカウントページです。これらの識別情報とアカウント指標は、プロフィール情報の補完、公開アカウントの比較、時系列のモニタリングに活用できます。

Threads Profiles API の主な機能

  • プロフィールURLの一括処理/@username パスを使う threads.com または threads.net のプロフィールURLを1つ以上処理し、投稿リンクや無関係なパスは拒否します。
  • 正規化されたプロフィール情報プロフィールID、URL、ユーザー名、表示名、プロフィール文、プロフィール画像、リンク先Webサイトを一貫したプロフィールレコードで返します。
  • 表示中のアカウントのスナップショット取得可能なフォロワー数・フォロー数・投稿数を collected_at とあわせて保持し、公開指標ごとに取得時刻がわかるようにします。

Threads Profiles API のパラメータ

パラメータ必須説明
urls必須必須。threads.com または threads.net 上の公開ThreadsプロフィールURLのリストです。各パスは /@username 形式である必要があり、ユーザー名のみ、投稿URL、無関係なパスは拒否されます。

Threads Profiles API の使い方

既知の公開プロフィールURLを送信し、非同期タスクを追跡して、正規化されたプロフィールレコードをカーソルページネーションで読み取ります。

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

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

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

  • 公開プロフィールの情報補完: 既知のThreadsプロフィールに関連するレコードに、ユーザー名、表示名、プロフィール文、プロフィール画像、Webサイト、元URLを追加します。
  • アカウント規模の比較: 選定した公開プロフィール間で、表示中のフォロワー数・フォロー数・投稿数を比較します。
  • 公開プロフィールのモニタリング: アカウント情報と表示中の指標を collected_at とともに保存し、取得時点ごとのプロフィールの見せ方やアカウント指標を比較します。

Threads Profiles API 活用のヒント

  • 投稿リンクや無関係なパスでリクエストが失敗しないよう、送信前に各URLが threads.com または threads.net の /@username パスに一致するか確認してください。
  • 送信するURLを正規化し、返されたプロフィールは id がある場合は id で、ない場合は url を代替の固定キーとして重複を排除してください。
  • 一部の情報しかない公開レコードも活用できるよう、プロフィール文、プロフィール画像、Webサイト、個々のアカウント指標は任意フィールドとして扱ってください。
  • 後の実行結果を別々の公開スナップショットとして区別できるよう、フォロワー数・フォロー数・投稿数とあわせて collected_at を保存してください。

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

  • Threads Posts API — 対応するThreadsの投稿URLから、公開投稿のテキスト、投稿者情報、メディア、タイムスタンプ、表示中のエンゲージメントを取得します。
  • 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 Profiles API — よくある質問

Threads Profiles APIは、対応する1つ以上のThreadsプロフィールURLから公開プロフィールレコードを取得します。正規化されたアカウント情報、プロフィール文、プロフィール画像、Webサイト、表示中のフォロワー数・フォロー数・投稿数、取得日時を返します。

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

結果には、プロフィールID、URL、ユーザー名、表示名、プロフィール文、プロフィール画像、Webサイト、フォロワー数・フォロー数・投稿数、取得日時が含まれる場合があります。

公開プロフィールのレコードに、プロフィール文、プロフィール画像、Webサイト、または表示中のすべての数値が含まれていない場合があります。クライアント側では、任意項目の null や空の値を許容してください。

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