Reddit Subreddit Search
指定したサブレディット内で検索することで、プラットフォーム全体のノイズから関連性の高い会話だけを切り出せます。コミュニティを限定した検索では、正規化された投稿タイトル、本文、投稿者のハンドル、コメント数、アップボート数、メディアリンクが返されます。
Reddit Subreddit Search API の主な機能
- コミュニティを限定したクエリプラットフォーム全体ではなく、特定の /r/{subreddit} コミュニティに限定してキーワード検索を行います。
- 細かな並び替えオプション調査の目的に合わせて、一致した投稿を関連度、hot、top、新着順、コメント数で並び替えます。
- 柔軟な期間フィルター1時間、1日、1週間、1か月、1年、または全期間の投稿期間で結果を絞り込みます。
- 充実した投稿の詳細タイトル、本文、投稿者、アップボート数、コメント数、パーマリンクを含む正規化された投稿レコードを受け取れます。
Reddit Subreddit Search API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
query | 必須 | 指定したサブレディットのコミュニティ内で実行する検索キーワードです。 |
urls | 必須 | 検索対象のコミュニティを定める公開Reddit /r/{subreddit} URLの配列です。 |
results_limit | 任意 | コミュニティごとに返す投稿の最大件数です。デフォルトは100で、1〜2,000の範囲で指定できます。 |
sort_by | 任意 | 一致した投稿の並び順です。relevance(デフォルト)、hot、top、new、comments を指定できます。 |
published_within | 任意 | 投稿期間のフィルターです。all(デフォルト)、year、month、week、day、hour を指定できます。 |
Reddit Subreddit Search API の使い方
検索クエリと対象コミュニティのURLを非同期タスクとして送信し、一致した投稿を取得します。
- 検索 query を指定し、urls に /r/{subreddit} 形式のコミュニティURLを1件以上指定します。
- 必要に応じて sort_by(relevance、hot、top、new、comments)と published_within(hour〜all)を選択します。
- SocQのAPIキーを使って /v1/reddit/subreddit-search に POST リクエストを送信します。
- /v1/tasks/{task_id} をポーリングし、next_cursor を使って data.results.items をページ送りで取得します。
curl -X POST "https://api.socq.ai/v1/reddit/subreddit-search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"AI agents","urls":["https://www.reddit.com/r/technology/"],"results_limit":20,"sort_by":"relevance"}'
# Poll GET /v1/tasks/{task_id}, then fetch data.results.items.Reddit Subreddit Search API の主なユースケース
- コミュニティの評判トラッキング: テック、金融、ゲームなどの専門サブレディットのメンバーが、自社ブランドや競合について何を話しているかをモニタリングします。
- 顧客の課題の発見: 製品に特化したサブレディット内でトラブルシューティングや質問に関するキーワードを検索し、ユーザーのペインポイントを見つけます。
- ニッチなテーマの過去調査: 信頼性の高いコミュニティに限定して、特定の技術的・文化的トピックに関する過去の上位ディスカッションを取得します。
Reddit Subreddit Search API 活用のヒント
- urls 配列には必ず完全な /r/{subreddit} URLを指定してください。コミュニティ名はバックエンドで自動的に抽出されます。
- コミュニティ横断のノイズを避けて1つのサブレディットに集中したい場合は、Reddit Searchの代わりにこのエンドポイントを使用してください。
- comments で並び替えると、コミュニティの意見が活発に交わされているエンゲージメントの高い議論スレッドを見つけやすくなります。
- Reddit Commentsと組み合わせると、見つかった関連性の高い投稿からコメントツリー全体を取得できます。
関連API
Reddit Subreddit Search API 以外に別の種類の公開Redditデータが必要な場合は、これらのAPIをご利用ください。
- Reddit Comments API — 対応する投稿URLから、公開コメントのテキスト、投稿者、投稿と親コメントの参照、コミュニティ情報、タイムスタンプ、表示中のエンゲージメントを取得します。
- Reddit Subreddit Posts API — サブレディットのURLから公開投稿を探します。new・top・hotの並び順とサブレディットごとの取得上限を指定でき、正規化されたコミュニティ情報とエンゲージメント情報を返します。
- Reddit Search API — テキストクエリと公開期間でRedditの公開投稿を検索し、正規化されたコンテンツ、投稿者、コミュニティ情報、タイムスタンプ、メディア、表示中のエンゲージメントを返します。
- Reddit Subreddit Details API
- Reddit Trending Searches API — 入力なしで今日のRedditのトレンド検索を取得し、各検索語の順位とRedditの検索結果へのリンクを返します。
- Reddit Answers API — 質問を送ると、RedditのAIによる回答を、引用コメント、元の投稿、おすすめのサブレディットとともに返します。