Reddit Posts
Reddit投稿はコミュニティへの投稿で、公開ページにはタイトル、本文、投稿者、フレア、メディア、投稿日時、表示中の投票数やコメント数が含まれることがあります。これらのフィールドをサブレディットと取得日時に結びつけることで、個々の投稿をソースの確認、コンテンツ分析、タイムスタンプ付きの比較に活用できます。
Reddit Posts API の主な機能
- 投稿の直接取得対応するRedditのディスカッションURLまたは redd.it 短縮リンクから、その公開投稿の正規化レコードを取得します。サブレディットのトップページや無関係なパスは拒否されます。
- 投稿内容と投稿者情報投稿ID、公開URL、タイトル、本文、取得可能な投稿者IDを返し、各アイテムをソースまでたどれるようにします。
- サブレディットと分類の情報ソースが提供している場合、フレアに加え、コミュニティ名、URL、表示中のメンバー数を extra に含めて返します。
- メディア・エンゲージメント・取得日時メディアの参照、created_at、collected_at、upvotes_count、comments_count、upvote_ratio をまとめて、タイムスタンプ付きのスナップショットとして保持します。
Reddit Posts API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
urls | 必須 | 必須。対応するRedditホスト上の /r/{subreddit}/comments/{post_id} パス、または redd.it 短縮リンクを使った公開Reddit投稿URLのリストです。 |
Reddit Posts API の使い方
必要な公開投稿を指定して送信し、非同期タスクを追跡して、正規化されたレコードをカーソルページネーションで読み取ります。
- 対応する comments パスまたは redd.it 短縮リンクを使った公開Reddit投稿URLを1件以上用意します。
- リンクを urls として /v1/reddit/posts に送信し、返された task_id を保存します。
- タスクが成功するか失敗を返すまで /v1/tasks/{task_id} をポーリングします。
- data.results.items を読み取り、has_more が true の間は返された next_cursor を指定して続きを取得します。
curl -X POST "https://api.socq.ai/v1/reddit/posts" \
-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 Posts API の主なユースケース
- ソースに基づく投稿レビュー: 投稿ID、URL、タイトル、本文、投稿者のフィールドを保持し、分析に含めた公開投稿をレビュー担当者があとから正確に確認できるようにします。
- コミュニティ横断のトピック比較: タイトルと本文を community_name と tag でグループ化し、特定のトピックが選んだサブレディット間でどのように語られているかを分析します。
- タイムスタンプ付きのエンゲージメント追跡: upvotes_count、comments_count、upvote_ratio を collected_at とあわせて保存し、値を固定のものとみなさずに繰り返し取得したスナップショットを比較します。
Reddit Posts API 活用のヒント
- 短縮リンクと完全なディスカッションURLが同じ投稿を指すことがあるため、まとめて送信する前に redd.it リンクを解決し、投稿IDで重複を除外してください。
- このエンドポイントは投稿URLがすでにわかっている場合に使用してください。サブレディットのトップページ、検索クエリ、並び替えの指定、results_limit は受け付けません。
- 公開ソースで公開されていない場合に備え、投稿者、メディア、タグ、コミュニティ情報、タイムスタンプ、指標が null になることを許容してください。
- あとのスナップショットと観測日時を上書きせずに比較できるよう、表示中のエンゲージメント指標と並べて collected_at を保存してください。
関連API
Reddit Posts API 以外に別の種類の公開Redditデータが必要な場合は、これらのAPIをご利用ください。
- Reddit Comments API — 対応する投稿URLから、公開コメントのテキスト、投稿者、投稿と親コメントの参照、コミュニティ情報、タイムスタンプ、表示中のエンゲージメントを取得します。
- Reddit Subreddit Posts API — サブレディットのURLから公開投稿を探します。new・top・hotの並び順とサブレディットごとの取得上限を指定でき、正規化されたコミュニティ情報とエンゲージメント情報を返します。
- Reddit Search API — テキストクエリと公開期間でRedditの公開投稿を検索し、正規化されたコンテンツ、投稿者、コミュニティ情報、タイムスタンプ、メディア、表示中のエンゲージメントを返します。
- Reddit Subreddit Details API
- Reddit User Posts API — 1つのユーザー名から、Redditユーザーの投稿履歴を new・top・hot の順で、タイトルと本文、スコア、コメント数、メディアとともに取得します。
- Reddit Popular Feed API — r/popular の投稿を hot・best・new・rising・top の順で、タイトルと本文、投稿者、スコア、コメント数、メディアとともに取得します。