Reddit User Comments
Redditユーザーのコメント履歴は、アカウントが他人のスレッドに残してきた返信の記録で、それぞれに発言の抜粋、スコア、書き込まれた日時、コメントへのリンク、コメント先の投稿が含まれます。コメントには本人の投稿以上に知識や関心がはっきり表れることが多く、専門家や見込み客の見極め、アカウントが製品をどう語っているかの追跡、活発なメンバーを通じたコミュニティの声の把握に役立ちます。
Reddit User Comments API の主な機能
- 1つのユーザー名からコメント履歴username に1つのアカウントを指定し、sort_by でコメントを new・top・hot の順に並べ、results_limit で1〜1000件(デフォルト100件)を取得します。
- 各コメントへの直接リンクurl はスレッド内のそのコメントを開くため、どの行からでも返信の全文と前後のやり取りへすぐ移動できます。
- すべての返信に投稿の参照post_id はコメントが書き込まれた投稿を示し、返信をスレッド単位でまとめたり、投稿レベルのデータと結び付けたりできます。
- コメントごとのスコアmetrics.likes_count にはコメントのスコアが入り、その返信がほかの読者にどう受け止められたかを手早く測れます。
Reddit User Comments API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
username | 必須 | Redditユーザー名を1つ指定します(u/ の有無は問いません)。英数字、ハイフン、アンダースコアの3〜20文字です。 |
sort_by | 任意 | コメントの並び順です。new(デフォルト)、top、hot から選びます。 |
results_limit | 任意 | 取得するコメントの最大件数で、1〜1000の整数です。デフォルトは100です。 |
Reddit User Comments API の使い方
ユーザー名を1つ、並び順と件数の上限とともに送信し、コメントをページごとに読み取ります。
- {"username": "spez", "sort_by": "top", "results_limit": 100} を /v1/reddit/user-comments に POST します。
- status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
- results.items からコメントを読み取り、has_more が true の場合は results.next_cursor を渡して次のページを取得します。
curl -X POST "https://api.socq.ai/v1/reddit/user-comments" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username":"spez","sort_by":"top","results_limit":100}'Reddit User Comments API の主なユースケース
- 専門家や見込み客の見極め: 候補者のコメントの text 抜粋と likes_count を読み、質問に的確に答えているか、周囲から評価されているかを判断します。
- アカウントによる製品への言及の追跡: text を自社ブランドや製品名で絞り込み、url で返信の全文を開き、published_at で1つのアカウントの意見の移り変わりを追います。
- 活発なメンバーから見るコミュニティの声: あるサブレディットの常連メンバー数人のコメントを集め、言葉遣いやスコアを比べて、そのオーディエンスの語り口をつかみます。
Reddit User Comments API 活用のヒント
- スレッドのタイトル、コミュニティ、スコアが必要な場合は、post_id から https://redd.it/{post_id} の短縮リンクを作り、Reddit Posts API に送ってください。
- 履歴全体を集めずにアカウントの高スコアの返信だけを取り出すには、sort_by を top にして results_limit を小さく設定してください。
- コメントは id で保存し、同じユーザー名を再実行するときは保存済みの id を飛ばしてください。繰り返しチェックしても重複行が生まれません。
関連API
Reddit User Comments API 以外に別の種類の公開Redditデータが必要な場合は、これらのAPIをご利用ください。
- Reddit Posts API — 対応するReddit URLから、公開投稿のテキスト、投稿者、コミュニティ情報、メディア、タイムスタンプ、表示中のエンゲージメントを取得します。
- Reddit Comments API — 対応する投稿URLから、公開コメントのテキスト、投稿者、投稿と親コメントの参照、コミュニティ情報、タイムスタンプ、表示中のエンゲージメントを取得します。
- Reddit Subreddit Posts API — サブレディットのURLから公開投稿を探します。new・top・hotの並び順とサブレディットごとの取得上限を指定でき、正規化されたコミュニティ情報とエンゲージメント情報を返します。
- Reddit Search API — テキストクエリと公開期間でRedditの公開投稿を検索し、正規化されたコンテンツ、投稿者、コミュニティ情報、タイムスタンプ、メディア、表示中のエンゲージメントを返します。
- Reddit User Profile API — ユーザー名からRedditアカウントを照会し、合計・投稿・コメント別のカルマ、活動件数、アカウント歴、プロフィールのフラグを返します。
- Reddit User Posts API — 1つのユーザー名から、Redditユーザーの投稿履歴を new・top・hot の順で、タイトルと本文、スコア、コメント数、メディアとともに取得します。