Reddit Answers
Reddit AnswersはRedditに組み込まれたAI検索で、質問するとRedditの投稿やコメントから回答を書き、根拠にしたコメントを引用し、もとになったスレッドへのリンクと、そのテーマを扱うコミュニティを示します。こうした回答を読むと、ある質問に対してRedditのユーザーがどの商品、意見、スレッドを挙げているのか、そしてブランドやカテゴリについて人々が目にする内容をどのコミュニティが形づくっているのかがわかります。
Reddit Answers API の主な機能
- 1文の要約とMarkdownの回答全文summary には回答の冒頭にある1文の結論が、answer には見出し、箇条書き、引用コメントを含むMarkdownの全文が入ります。
- リンク付きの引用コメントcitations には回答が使った引用ごとに、本文、リンク、サブレディット、コメントと投稿のどちらから引いたかが入るため、すべての主張を出典までたどれます。
- 回答のもとになった投稿source_posts には各スレッドのタイトル、本文、サブレディット、投稿者、スコア、コメント数、投稿日時が入り、回答の裏にどれだけの議論があるかで並べ替えられます。
- Redditがすすめるサブレディットrecommended_subreddits には、その質問に対してRedditが案内するコミュニティが、タイトル、説明、メンバー数とともに入ります。
- 次に聞く質問の候補follow_up_queries にはRedditが提案する次の質問が入り、次のタスクでそのまま使える関連検索のリストになります。
Reddit Answers API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
query | 必須 | Reddit Answersに送る質問です。500文字以内で、言語は問いません。 |
Reddit Answers API の使い方
人が実際に入力するような言い方で質問を書き、Reddit Answers APIに送信して、完了したタスクから回答を読み取ります。
- {"query": "what do people say about standing desks for back pain"} を /v1/reddit/answers に POST し、task_id を控えておきます。
- status が succeeded になるまで、数秒ごとに GET /v1/tasks/{task_id} を呼び出します。回答にはふつう15〜30秒かかります。
- results.items にある回答の行を、citations、source_posts、recommended_subreddits とあわせて読み取ります。
curl -X POST "https://api.socq.ai/v1/reddit/answers" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"best budget espresso machine for beginners"}'
# The response contains a task_id.
# GET /v1/tasks/{task_id} returns the answer once status is succeeded.Reddit Answers API の主なユースケース
- RedditのAI検索でのブランドの見え方を確認: 「小規模エージェンシー向けのおすすめCRM」のように購入検討者が実際にする質問を送り、summary、answer、citations を読んで、自社と競合のどちらがすすめられているか、その見方をどのコメントが支えているかを確かめます。
- 商品やカテゴリのリサーチ: あるニーズに対してRedditのユーザーがすすめるものを、引用コメントと、各候補を支える議論の量を示す source_posts のスコアやコメント数とあわせて集めます。
- AIアシスタントの回答をRedditの声で裏付け: Markdownの回答と citations をエージェントやRAGパイプラインに渡し、実際のRedditユーザーの言葉を引用しながら、元のコメントへのリンクを残した返答にします。
- 参加・観測するコミュニティ探し: recommended_subreddits と citations に出てくるサブレディットから、あるテーマが話されている場所を見つけ、メンバー数の順に並べます。
Reddit Answers API 活用のヒント
- query はターゲットが検索するときの言い回しで書き、いくつかの言い方を試してください。Reddit Answers APIは、その言い回しそのものに対してRedditが書いた回答を返します。
- 重要な質問は定期的に送り直し、summary と citations を比べてください。新しいスレッドが投稿され、投票が集まるにつれて回答は変わります。
- follow_up_queries を次のタスクに渡すと、あるテーマのまわりで人々がしている関連質問を洗い出せます。
- 回答のもとになったスレッド全体を読むには、source_posts のURLを Reddit Posts API または Reddit Comments API に渡してください。
関連API
Reddit Answers API 以外に別の種類の公開Redditデータが必要な場合は、これらのAPIをご利用ください。
- Reddit Posts API — 対応するReddit URLから、公開投稿のテキスト、投稿者、コミュニティ情報、メディア、タイムスタンプ、表示中のエンゲージメントを取得します。
- Reddit Comments API — 対応する投稿URLから、公開コメントのテキスト、投稿者、投稿と親コメントの参照、コミュニティ情報、タイムスタンプ、表示中のエンゲージメントを取得します。
- Reddit Search API — テキストクエリと公開期間でRedditの公開投稿を検索し、正規化されたコンテンツ、投稿者、コミュニティ情報、タイムスタンプ、メディア、表示中のエンゲージメントを返します。
- Reddit Subreddit Details API
- Reddit Subreddit Search API
- Reddit Trending Searches API — 入力なしで今日のRedditのトレンド検索を取得し、各検索語の順位とRedditの検索結果へのリンクを返します。