threads/
search-users

名前やユーザー名でThreadsアカウントを探し、Threadsが候補として示すアカウントを通常最大10件、ユーザー名、表示名、プロフィールURL、アバター、認証状態とともに返します。

Threads User Search API

名前・ユーザー名で検索
最大約10件の候補
認証状態
結果1件あたり0.6クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Threads User Search

Threadsのユーザー検索は、入力した名前やハンドルに対してアプリが候補として示すアカウントの一覧で、各アカウントはユーザー名、表示名、プロフィールリンク、アバター、認証バッジで識別されます。これらの識別情報を使えば、本人やブランドの本物のアカウントを似た名前のアカウントと見分け、名前だけのリストを確認済みのThreadsプロフィールに置き換えられます。

Threads User Search API の主な機能

  • 名前とハンドルの両方で照合query には表示名とユーザー名のどちらも指定でき、レスポンスにはThreadsが候補として示すアカウントが通常最大10件入ります。
  • すぐに使える識別フィールド各候補は username、name、url を返し、url はほかのThreadsエンドポイントが入力として受け付ける /@username 形式のプロフィールリンクです。
  • 見分けに役立つバッジとアバター同じ名前の候補が複数あるときは、is_verified と avatar_url が本物のアカウントを選ぶ手がかりになります。

Threads User Search API のパラメータ

パラメータ必須説明
query必須人物やブランドの名前、またはThreadsのユーザー名です(例:shams)。

Threads User Search API の使い方

名前で検索し、候補のアカウントを読み取ります。

  1. {"query": "shams"} を /v1/threads/search-users に POST します。
  2. 返された task_id で、status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
  3. results.items から一致したアカウントを読み取り、has_more が true のときは results.next_cursor をたどります。
curl -X POST "https://api.socq.ai/v1/threads/search-users" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"shams"}'

# 0.6 credits for each account returned.

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

  • コンテンツ取得前のハンドル確認: username、表示名、is_verified で正しい候補を確かめ、その url を使ってアカウントの投稿、返信、リポストを取得します。
  • 名前リストのThreadsプロフィール化: インフルエンサーやメディア関係者のリストにある名前を1つずつ検索し、認証済みの候補の url を残して、Threadsプロフィールリンクの列を作ります。
  • なりすましに似たアカウントの発見: ブランドや著名人を検索し、名前やアバターがほぼ同じ未認証の候補を確認して、なりすましやファンページの可能性を洗い出します。

Threads User Search API 活用のヒント

  • 目的のアカウントが最初の候補に見当たらない場合は、フルネームと想定されるハンドルの両方を試してください。query はどちらにも一致します。
  • よくある名前では似たアカウントが複数返るため、先頭の行をそのまま採用せず、username と is_verified で候補を選んでください。
  • 選んだ url はそのまま Threads User Posts、User Replies、User Reposts API に渡せます。いずれも同じ形式のプロフィールリンクを受け付けます。

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

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

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

Threads User Search API — よくある質問

Threads User Search APIは、名前やユーザー名からThreadsアカウントを見つけるためのプログラムインターフェースです。Threadsが候補として示すアカウントを、ユーザー名、表示名、プロフィールリンク、アバター、認証状態とともに返します。

通常は最大10件で、入力した名前やユーザー名に対してThreadsが示す候補と同じ内容です。

検索結果はアカウントの特定を目的としています。各候補の url を Threads Profiles API に送れば、プロフィール文、Webサイト、表示中のフォロワー数を取得できます。

返されたアカウント1件につき0.6クレジットで、10件の候補がある検索なら6クレジットです。