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 の使い方
空のリクエストを送信し、現在のトレンド一覧を読み取ります。
- 空のJSONボディ {} を /v1/reddit/trending-searches に POST します。
- status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
- 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 に渡してください。
関連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による回答を、引用コメント、元の投稿、おすすめのサブレディットとともに返します。