reddit/
answers

RedditのAI検索に質問を送り、要約と回答全文、引用されたコメント、回答のもとになった投稿、Redditがすすめるサブレディットを返します。

Reddit Answers API

RedditのAI検索
引用コメント
元になった投稿
結果1件あたり6クレジット
準備完了
準備完了

パラメータを入力してリクエストを送信してください。タスクのステータスと正規化された結果がここに表示されます。

README

SocQ 編集 · 更新

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に送信して、完了したタスクから回答を読み取ります。

  1. {"query": "what do people say about standing desks for back pain"} を /v1/reddit/answers に POST し、task_id を控えておきます。
  2. status が succeeded になるまで、数秒ごとに GET /v1/tasks/{task_id} を呼び出します。回答にはふつう15〜30秒かかります。
  3. 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 に渡してください。

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の検索結果へのリンクを返します。

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

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

Reddit Answers API — よくある質問

Reddit Answers APIは、RedditのAI検索であるReddit Answersに質問し、その回答を取得するためのプログラムインターフェースです。要約と回答全文、リンク付きの引用コメント、スコア付きの元投稿、おすすめのサブレディット、提案される追加の質問を返します。

Reddit AnswersはRedditの中にあるAI検索です。Redditの投稿やコメントを要約して質問に答え、参考にしたコメントやスレッドを示します。

source_posts を見ると、回答の裏にあるスレッドがタイトル、サブレディット、スコア、コメント数とともにわかります。citations には回答がそのまま引用したコメントが、それぞれのリンクとともに入っています。

はい。顧客が自社のカテゴリについてする質問をReddit Answers APIで送り、summary や answer にブランドが登場するかを確認して、ブランドに触れた citations を保存します。同じ質問を繰り返し送れば、時間の経過に伴う変化を追えます。

はい。query を必要な言語で書いてください。たとえばスペイン語で質問すると、回答もスペイン語で返り、引用もスペイン語で表示されます。

Reddit Answers APIは返された回答1件につき6クレジットで、回答が得られた質問にだけ料金がかかります。