reddit/
comments

投稿URLから公開Redditコメントを取得し、本文、投稿者とスレッドの情報、タイムスタンプ、表示中のエンゲージメントを正規化されたレコードで返します。

Reddit Comments API

投稿URLで指定
スレッドの参照
エンゲージメントのスナップショット
結果1件あたり0.3クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

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を送信し、非同期タスクを追跡して、正規化されたコメントレコードをカーソルページネーションで読み取ります。

  1. 対応する公開Reddit投稿URLまたは redd.it 短縮リンクを1件以上用意します。
  2. リンクを urls として /v1/reddit/comments に送信し、返された task_id を保存します。
  3. タスクが成功するか失敗を返すまで /v1/tasks/{task_id} をポーリングします。
  4. 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 true

Reddit 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 で続きを取得してください。

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とともに取得します。

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

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

Reddit Comments API — よくある質問

Reddit Comments APIは、対応するReddit投稿URLから公開コメントのレコードを取得し、正規化された本文、投稿者データ、元の投稿と親コメントへの参照、タイムスタンプ、表示中の反応指標を返すAPIです。

reddit.com、www.reddit.com、old.reddit.com、new.reddit.com 上で、パスが /r/{subreddit}/comments/{post_id} で始まる http または https のURLを送信してください。redd.it と www.redd.it の短縮リンクも使用できます。

できません。Reddit Comments APIは results_limit を拒否し、受け付けた各投稿URLについて返されたコメントレコードを保存します。料金は実際の結果件数に基づいて計算されます。

値が取得可能な場合、返されるレコードには post_id、post_url、parent_comment_id、community_name、input_url が含まれます。これらのフィールドで取得したコメント同士を関連付けられますが、スレッドの完全な深さを保証するものではありません。

含まれません。コメントには参照用に post_id と post_url が含まれる場合がありますが、元の投稿のタイトルや本文は正規化されたコメントレコードには含まれません。

返されたコメントレコード1件につき0.3 SocQクレジットです。結果が空の場合は結果の料金はかかりません。