Reddit Subreddit Posts
サブレディットの投稿は、タイトル、本文、投稿者、フレア、メディア、投稿日時、表示中の投票数とコメント数を含む公開のコミュニティ投稿です。これらのコンテンツ、コンテキスト、エンゲージメントのフィールドは、コミュニティのモニタリング、トピック調査、サブレディットの一覧を同じ条件でそろえた比較に活用できます。
Reddit Subreddit Posts API の主な機能
- サブレディット一覧からの投稿取得対応する /r/{subreddit} 形式のURLから公開投稿を取得し、リクエスト内のすべてのサブレディットに new、top、hot のいずれかの一覧を適用します。
- サブレディットごとの取得件数results_limit は送信した各サブレディットURLに個別に適用されます。デフォルトは100で、1〜2,000の範囲で指定できます。
- 正規化された投稿内容と投稿者投稿ID、ソースURL、タイトル、本文、取得可能な投稿者フィールド、メディアの参照を一貫したレコード形式で返します。
- コミュニティとエンゲージメントの情報フレア、コミュニティの詳細、投稿日時と取得日時、upvotes_count、comments_count、upvote_ratio、discovery_input を各投稿に保持します。
Reddit Subreddit Posts API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
urls | 必須 | 必須。対応するRedditホスト上で、パスが厳密に /r/{subreddit} である公開サブレディットURLのリストです。 |
results_limit | 任意 | サブレディットURLごとにリクエストする投稿の最大件数です。デフォルトは100で、1〜2,000の整数を指定できます。 |
sort_by | 任意 | 送信したすべてのサブレディットURLに適用される一覧です。デフォルトは new で、new、top、hot を指定できます。 |
Reddit Subreddit Posts API の使い方
公開サブレディットURLに一覧モードとサブレディットごとの結果件数上限を指定して送信し、非同期タスクの結果をカーソルページネーションで読み取ります。
- パスが /r/{subreddit} の公開Reddit URLを1件以上用意します。
- urls、results_limit、sort_by を /v1/reddit/subreddit-posts に POST し、返された task_id を保存します。
- タスクが成功するか失敗を返すまで /v1/tasks/{task_id} をポーリングします。
- data.results.items を読み取り、has_more が true の間は返された next_cursor を指定して続きを取得します。
curl -X POST "https://api.socq.ai/v1/reddit/subreddit-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.reddit.com/r/learnpython/"],"results_limit":100,"sort_by":"new"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueReddit Subreddit Posts API の主なユースケース
- コミュニティ投稿のモニタリング: new の一覧を取得し、投稿ID、created_at、collected_at、タイトル、本文を保持して、選んだサブレディットの最近の公開投稿を確認します。
- サブレディットのトピック調査: タイトル、本文、フレア、コミュニティのフィールドをグループ化し、特定の公開コミュニティ内で繰り返し登場するテーマや投稿形式を分析します。
- 条件をそろえた一覧の比較: サブレディットURL間で同じ sort_by を使用し、1つの一覧モードのもとで投稿日時、upvotes_count、comments_count、upvote_ratio を比較します。
Reddit Subreddit Posts API 活用のヒント
- URLの検証を通過するよう、サブレディット名や投稿URL、より深いパスではなく、正規の /r/{subreddit} のトップURLを送信してください。
- 上限とクレジットの見積もりはサブレディットごとに個別に適用されるため、リクエストする件数は urls の数に results_limit を掛けた値として計算してください。
- 1つのリクエストではすべてのサブレディットURLに同じ sort_by の値が適用されるため、new、top、hot を比較する場合は別々のタスクを実行してください。
- 下流のデータセットでソースのサブレディットと観測日時を保持できるよう、各レコードに discovery_input と collected_at を残してください。
- 公開一覧で公開されていない場合に備え、投稿者、メディア、フレア、コミュニティ、タイムスタンプ、エンゲージメントのフィールドが null または空になることを許容してください。
関連API
Reddit Subreddit Posts API 以外に別の種類の公開Redditデータが必要な場合は、これらのAPIをご利用ください。
- Reddit Posts API — 対応するReddit URLから、公開投稿のテキスト、投稿者、コミュニティ情報、メディア、タイムスタンプ、表示中のエンゲージメントを取得します。
- Reddit Comments API — 対応する投稿URLから、公開コメントのテキスト、投稿者、投稿と親コメントの参照、コミュニティ情報、タイムスタンプ、表示中のエンゲージメントを取得します。
- 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 の順で、タイトルと本文、投稿者、スコア、コメント数、メディアとともに取得します。