Reddit Comments
Redditコメントは投稿のディスカッション内にある公開の返信で、本文、投稿者情報、元の投稿と親コメントへの参照、コミュニティ情報、タイムスタンプ、表示中の投票数と返信数を含みます。これらのフィールドをあわせて読むことで、返されたコメントを反応の分析、返信関係のマッピング、ソースにリンクしたアーカイブ、タイムスタンプ付きの比較に活用できます。
Reddit Comments API の主な機能
- 指定したディスカッションのコメント対応するReddit投稿URLまたは redd.it 短縮リンクを受け付け、そのディスカッションで提供されている公開コメントのレコードを返します。
- コメント内容と投稿者取得可能な各コメントのID、公開URL、本文、投稿者IDを、それぞれ独立した正規化レコードとして返します。
- 投稿と返信の参照post_id、post_url、parent_comment_id、community_name、input_url を返し、取得したコメントをソースやコメント同士と関連付けられるようにします。
- 表示中の反応のスナップショットupvotes_count と replies_count を created_at、collected_at とあわせて保持し、投稿日時と観測日時を区別できるようにします。
Reddit Comments API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
urls | 必須 | 必須。対応するRedditホスト上の /r/{subreddit}/comments/{post_id} パス、または redd.it 短縮リンクを使った公開Reddit投稿URLのリストです。 |
Reddit Comments API の使い方
公開Reddit投稿URLを送信し、非同期タスクを追跡して、正規化されたコメントレコードをカーソルページネーションで読み取ります。
- 対応する公開Reddit投稿URLまたは redd.it 短縮リンクを1件以上用意します。
- リンクを urls として /v1/reddit/comments に送信し、返された task_id を保存します。
- タスクが成功するか失敗を返すまで /v1/tasks/{task_id} をポーリングします。
- data.results.items を読み取り、has_more が true の間は返された next_cursor を指定して続きを取得します。
curl -X POST "https://api.socq.ai/v1/reddit/comments" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.reddit.com/r/example/comments/post_id/example_post/"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueReddit Comments API の主なユースケース
- 定性的な反応の分析: コメント本文と取得可能な投稿者フィールドを分析し、選んだディスカッション内の主張、質問、繰り返し見られる反応を把握します。
- 取得した返信の関係マッピング: コメントIDと parent_comment_id を使って、返されたレコードに含まれる返信同士をつなぎます。スレッド全体が取得されているとは想定しないでください。
- ソースにリンクしたコメントのアーカイブ: コメントURL、post_id、post_url、community_name、タイムスタンプを保持し、保存したすべての返信にディスカッションのコンテキストを残します。
- タイムスタンプ付きの反応比較: 各観測を collected_at に結びつけたうえで、返されたコメント間で upvotes_count と replies_count を比較します。
Reddit Comments API 活用のヒント
- 同じディスカッションを複数のURL形式で送信しないよう、まとめて送信する前に redd.it リンクを解決し、元の投稿で重複を除外してください。
- results_limit は送信しないでください。このエンドポイントは results_limit を拒否し、受け付けた各投稿URLについて返されたコメントを保存します。
- parent_comment_id はスレッドの完全な深さを保証しないため、結果セットに実際に含まれるレコード同士をつなぐ目的でのみ使用してください。
- 公開ソースで省略されている場合に備え、本文、投稿者フィールド、parent_comment_id、community_name、タイムスタンプ、指標が null になることを許容してください。
- 完了したタスクのコメントをAPIの結果ページの境界で取りこぼさないよう、has_more が false になるまで next_cursor で続きを取得してください。
関連API
Reddit Comments API 以外に別の種類の公開Redditデータが必要な場合は、これらのAPIをご利用ください。
- Reddit Posts API — 対応するReddit URLから、公開投稿のテキスト、投稿者、コミュニティ情報、メディア、タイムスタンプ、表示中のエンゲージメントを取得します。
- Reddit Subreddit Posts API — サブレディットのURLから公開投稿を探します。new・top・hotの並び順とサブレディットごとの取得上限を指定でき、正規化されたコミュニティ情報とエンゲージメント情報を返します。
- Reddit Search API — テキストクエリと公開期間でRedditの公開投稿を検索し、正規化されたコンテンツ、投稿者、コミュニティ情報、タイムスタンプ、メディア、表示中のエンゲージメントを返します。
- Reddit Subreddit Details API
- Reddit Subreddit Search API
- Reddit User Comments API — 1つのユーザー名から、Redditユーザーのコメント履歴を300文字の抜粋、スコア、コメントのリンク、投稿IDとともに取得します。