threads/
search

キーワードやハッシュタグでThreadsを検索し、アプリが表示する上位の投稿を1回あたり約20件、本文、投稿者、いいね数、返信数、リポスト数、メディア、投稿日時とともに取得します。

Threads Search API

キーワード・ハッシュタグで検索
Threadsの順位どおりの上位投稿
いいね・返信・リポスト
結果1件あたり0.6クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Threads Search

Threadsの検索は、キーワードやハッシュタグに対してアプリがもっとも高く評価する投稿を表示する機能で、どの投稿にも本文、投稿者、投稿日時、添付の画像や動画、いいね・返信・リポストの数が付いています。そのため、話題、製品、イベントが今どう語られているか、どのアカウントが会話を引っ張っているかをすばやくつかめます。

Threads Search API の主な機能

  • 1つのクエリで上位の投稿query にキーワードやハッシュタグを入れると、Threadsがそれに対して表示する上位の投稿が、アプリと同じ順位で約20件返ります。
  • 各結果のいいね・返信・リポストmetrics.likes_count、返信数の metrics.comments_count、リポスト数の metrics.shares_count で、どの結果がもっとも注目を集めているかがわかります。
  • 各投稿の背後にいるアカウントauthor はユーザー名、表示名、プロフィールの url、アバター、is_verified を返すため、話題をリードする人物を発言内容とあわせて特定できます。
  • メディアと日時media には添付の画像や動画がサイズとともに並び、published_at で各投稿の新しさを確認できます。

Threads Search API のパラメータ

パラメータ必須説明
query必須検索するキーワードまたはハッシュタグです(例:basketball、キャンペーンのハッシュタグ)。1リクエストにつき1クエリです。

Threads Search API の使い方

クエリを送信し、タスクが完了したら上位の投稿を読み取ります。

  1. {"query": "basketball"} を /v1/threads/search に POST し、返された task_id を控えます。
  2. 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" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"basketball"}'

# 0.6 credits per post returned; a search with no matches is free.

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

  • 話題の温度感の把握: 製品、イベント、社会的なテーマを検索して上位投稿の text を読み、議論をリードしている視点や意見を確かめます。
  • 会話を動かす発信者の特定: 結果の投稿者を投稿が得たいいねとリポストで順位付けし、認証済みかどうかも記録して、アプローチ先や監視リストを作ります。
  • ブランド名やハッシュタグの監視: 同じクエリを定期的に実行し、新しい投稿の id と published_at を残していけば、新たな言及の記録が続いていきます。

Threads Search API 活用のヒント

  • 1回の検索で返る上位投稿は約20件なので、広いテーマは製品名、表記ゆれ、関連ハッシュタグなど、より絞った複数のクエリに分けてください。
  • 重なり合うクエリの結果は id でまとめ、2つの検索で上位に出た投稿を1回だけ数えるようにしてください。
  • レポートで列名を付けるときは、metrics.comments_count を返信数、metrics.shares_count をリポスト数として扱ってください。
  • 結果の下にある会話が必要なときは、その url を Threads Post Replies API に渡してください。

Threads 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 User Search API — 名前やユーザー名からThreadsアカウントを探し、ユーザー名、表示名、プロフィールURL、アバター、認証状態を返します。
  • Threads User Replies API — Threadsのプロフィールから、アカウントが最近投稿した公開返信を本文、エンゲージメント、メディア、リンクとともに取得します。

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

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

Threads Search API — よくある質問

Threads Search APIは、キーワードやハッシュタグで公開Threads投稿を検索するためのプログラムインターフェースです。クエリに対する上位の投稿を、本文、投稿者、いいね数、返信数、リポスト数、メディア、投稿日時とともに返します。

キーワードと同じようにハッシュタグを query に入れれば、Threadsがそのタグに対して上位に表示する投稿が返ります。

約20件が、Threadsがそのクエリの上位結果を並べる順で返ります。新しい順にしたい場合は、published_at で並べ替えてください。

返された投稿1件につき0.6クレジットで、約20件がそろった検索ならおよそ12クレジットです。