reddit/
trending-searches

入力なしで、今日Redditでトレンドになっている検索を取得し、各検索語、Redditの一覧での順位、その検索結果へのリンクを返します。

Reddit Trending Searches API

入力不要
順位付きリスト
検索結果へのリンク
1リクエストあたり0.5クレジット
準備完了
README

SocQ 編集 · 更新

Reddit Trending Searches

Redditのトレンド検索は、Redditが今日のトレンドとして示す短い検索語リストで、通常は6件ほどあり、それぞれに一覧での位置と対応する検索結果へのリンクが付き、進行中のニュース、新製品の発表、文化的な出来事がよく挙がります。1日を通して記録すれば、Redditのユーザーが今まさに調べていることがわかり、トレンドダッシュボード、タイムリーなコンテンツ企画、追っている話題がトレンド入りしたときのアラートに活用できます。

Reddit Trending Searches API の主な機能

  • 準備する入力なしリクエストボディは空なので、設定することなくスケジューラーからそのまま実行できます。
  • Redditの表示順どおりの順位rank は1から始まり、Redditがトレンド検索を並べている順に従います。
  • 検索語ごとの検索リンクkeyword には検索語が入り、url でその語のRedditの検索結果を開けるため、各トレンドの背景にある会話へすぐたどれます。

Reddit Trending Searches API のパラメータ

送信できます

このエンドポイントにはリクエストパラメータは不要です。空のJSONオブジェクトをそのまま送信してください。

{}

Reddit Trending Searches API の使い方

空のリクエストを送信し、現在のトレンド一覧を読み取ります。

  1. 空のJSONボディ {} を /v1/reddit/trending-searches に POST します。
  2. status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
  3. results.items から keyword と rank を読み取り、has_more が true の場合は results.next_cursor で残りを取得します。
curl -X POST "https://api.socq.ai/v1/reddit/trending-searches" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Reddit Trending Searches API の主なユースケース

  • トレンド履歴の蓄積: 実行ごとに keyword、rank、collected_at を保存し、話題がどれくらい一覧に残り、順位がどう上下したかをグラフにします。
  • タイムリーな投稿や記事の企画: 毎朝その時点の keyword を確認し、その日に投稿、ニュースレター、解説記事で取り上げるべき進行中の話題を決めます。
  • 注目キーワードのトレンド入り通知: 各 keyword をブランド名、製品名、業界用語のリストと照合し、いずれかがトレンド入りしたらチームに通知します。

Reddit Trending Searches API 活用のヒント

  • id は検索語そのものであり、同じ語は後のスナップショットにも再び現れるため、保存する行は keyword と collected_at の組み合わせをキーにしてください。
  • トレンドの背景にある投稿を本文、投稿者、エンゲージメントとともに知りたい場合は、keyword を query として Reddit Search API に渡してください。

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

  • Reddit Posts API — 対応するReddit URLから、公開投稿のテキスト、投稿者、コミュニティ情報、メディア、タイムスタンプ、表示中のエンゲージメントを取得します。
  • Reddit Search API — テキストクエリと公開期間でRedditの公開投稿を検索し、正規化されたコンテンツ、投稿者、コミュニティ情報、タイムスタンプ、メディア、表示中のエンゲージメントを返します。
  • Reddit Subreddit Details API
  • Reddit Subreddit Search API
  • Reddit Popular Feed API — r/popular の投稿を hot・best・new・rising・top の順で、タイトルと本文、投稿者、スコア、コメント数、メディアとともに取得します。
  • Reddit Answers API — 質問を送ると、RedditのAIによる回答を、引用コメント、元の投稿、おすすめのサブレディットとともに返します。

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

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

Reddit Trending Searches API — よくある質問

Reddit Trending Searches APIは、Redditが今日のトレンドとして挙げている検索を入力なしで取得するためのプログラムインターフェースです。各検索語を、順位とRedditの検索結果へのリンクとともに返します。

通常は6件で、Redditが並べている順に1位から順位が付きます。Redditに表示されている現在の一覧そのものです。

一覧に含まれる検索の数にかかわらず、1回の呼び出しにつき一律0.5クレジットです。