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 の使い方
クエリを送信し、タスクが完了したら上位の投稿を読み取ります。
- {"query": "basketball"} を /v1/threads/search に POST し、返された task_id を控えます。
- succeeded が返るまで GET /v1/tasks/{task_id} をポーリングします。
- 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 に渡してください。
関連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のプロフィールから、アカウントが最近投稿した公開返信を本文、エンゲージメント、メディア、リンクとともに取得します。