reddit/
subreddit-posts

サブレディットURLから new・top・hot の並び順で公開Reddit投稿を取得し、内容、投稿者、コミュニティ情報、メディア、表示中のエンゲージメントを正規化されたレコードで返します。

Reddit Subreddit Posts API

サブレディットURLで指定
new・top・hot
サブレディットごとの上限
結果1件あたり0.5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

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に一覧モードとサブレディットごとの結果件数上限を指定して送信し、非同期タスクの結果をカーソルページネーションで読み取ります。

  1. パスが /r/{subreddit} の公開Reddit URLを1件以上用意します。
  2. urls、results_limit、sort_by を /v1/reddit/subreddit-posts に POST し、返された 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/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 true

Reddit 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 または空になることを許容してください。

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 の順で、タイトルと本文、投稿者、スコア、コメント数、メディアとともに取得します。

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

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

Reddit Subreddit Posts API — よくある質問

Reddit Subreddit Posts APIは、対応するサブレディットURLから new、top、hot の並び順で公開投稿を取得するAPIです。正規化された内容、投稿者、コミュニティ情報、メディア、タイムスタンプ、表示中のエンゲージメントを返します。

対応するRedditホスト上で、パスが厳密に /r/{subreddit}(末尾のスラッシュは任意)である http または https のURLを送信してください。サブレディット名、投稿URL、より深いパスは受け付けません。

sort_by は new、top、hot に対応し、デフォルトは new です。top の一覧に対する期間指定のパラメータは受け付けません。

results_limit のデフォルトは100で、1〜2,000の値を指定できます。上限はURLごとに個別に適用されるため、results_limit を50にして2つのURLを指定すると、最大100件の投稿をリクエストすることになります。

含まれません。各投稿には comments_count が含まれる場合がありますが、コメント本文やコメント投稿者は結果に含まれません。

公開一覧で利用可能な値が公開されていない場合、投稿者の詳細、メディア、フレア、コミュニティ情報、投稿日時、エンゲージメントの値が null または空になることがあります。

返された投稿レコード1件につき0.5 SocQクレジットです。リクエスト前の見積もりには urls の数に results_limit を掛けた値が使われ、結果が空の場合は結果の料金はかかりません。