reddit/
popular-feed

Redditの r/popular フィードで話題の投稿を5種類の並び順のいずれかで取得し、タイトルと本文、投稿者、スコア、コメント数、メディアを1リクエスト最大500件まで返します。

Reddit Popular Feed API

入力不要
5種類の並び順
top の期間指定
最大500件の投稿
結果1件あたり0.5クレジット
準備完了
README

SocQ 編集 · 更新

Reddit Popular Feed

Redditの人気フィード r/popular は、サイト内の複数のコミュニティで同時に勢いを増している投稿の流れで、各投稿にタイトルと本文、投稿者、スコア、コメント数、投稿日時、添付された画像や動画が付いています。並び順や期間を変えて読むと、どのニュース、形式、話題がプラットフォーム全体で注目を集めているかがわかり、ニュースの早期発見、コンテンツ形式の研究、Redditで今語られていることのサンプリングに役立ちます。

Reddit Popular Feed API の主な機能

  • r/popular を5通りの順で取得sort_by でフィードを best、hot、new、rising、top のいずれかの順に読み込み、省略時は hot が使われます。
  • top 順の期間指定published_within で top を過去1時間、1日、1週間、1か月、1年、または全期間に絞り込めます。デフォルトは day です。
  • 投稿者とメディアを含む投稿データ各行にはタイトルと本文を含む text、投稿の url、投稿者のユーザー名とプロフィールリンク、likes_count のスコア、comments_count、ピクセルサイズ付きの media が入ります。

Reddit Popular Feed API のパラメータ

パラメータ必須説明
sort_by任意r/popular の並び順です。best、hot(デフォルト)、new、rising、top から選びます。
published_within任意sort_by が top のときに使う期間です。hour、day(デフォルト)、week、month、year、all から選びます。
results_limit任意取得する投稿の最大件数で、1〜500の整数です。デフォルトは25です。

Reddit Popular Feed API の使い方

並び順と件数の上限を選ぶか、空のボディを送信して、フィードをページごとに読み取ります。

  1. {"sort_by": "hot", "results_limit": 25} を /v1/reddit/popular-feed に POST します。
  2. status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
  3. results.items から投稿を読み取り、has_more が true の間は results.next_cursor で続きのページを読み込みます。
curl -X POST "https://api.socq.ai/v1/reddit/popular-feed" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sort_by":"hot","results_limit":25}'

Reddit Popular Feed API の主なユースケース

  • ピーク前の話題の発見: sort_by を rising または new にして定期的に取得し、published_at、likes_count、comments_count を見て、r/popular で勢いを増している投稿を見つけます。
  • 週間トップ投稿のまとめ: sort_by を top、published_within を week にして取得し、過去7日間に注目を集めた投稿の url、text、スコアを一覧にします。
  • r/popular に届く投稿形式の研究: 投稿をメディアの種類で画像、動画、テキストのみに分け、グループごとに likes_count と comments_count を比較します。

Reddit Popular Feed API 活用のヒント

  • 期間は top 順にだけ適用されるため、published_within を使うときは必ず sort_by を top にしてください。
  • 動きの速いフィードでは同じ投稿が連続した取得に何度も現れるため、スナップショットごとに collected_at を記録し、id で重複を除いてください。
  • 同じ投稿者が何度も現れる場合は、author.username を Reddit User Profile API に送り、カルマやアカウント歴を確認してください。

Reddit Popular Feed API 以外に別の種類の公開Redditデータが必要な場合は、これらのAPIをご利用ください。

  • Reddit Posts API — 対応するReddit URLから、公開投稿のテキスト、投稿者、コミュニティ情報、メディア、タイムスタンプ、表示中のエンゲージメントを取得します。
  • Reddit Comments API — 対応する投稿URLから、公開コメントのテキスト、投稿者、投稿と親コメントの参照、コミュニティ情報、タイムスタンプ、表示中のエンゲージメントを取得します。
  • Reddit Subreddit Posts API — サブレディットのURLから公開投稿を探します。new・top・hotの並び順とサブレディットごとの取得上限を指定でき、正規化されたコミュニティ情報とエンゲージメント情報を返します。
  • Reddit Search API — テキストクエリと公開期間でRedditの公開投稿を検索し、正規化されたコンテンツ、投稿者、コミュニティ情報、タイムスタンプ、メディア、表示中のエンゲージメントを返します。
  • Reddit User Posts API — 1つのユーザー名から、Redditユーザーの投稿履歴を new・top・hot の順で、タイトルと本文、スコア、コメント数、メディアとともに取得します。
  • Reddit Trending Searches API — 入力なしで今日のRedditのトレンド検索を取得し、各検索語の順位とRedditの検索結果へのリンクを返します。

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

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

Reddit Popular Feed API — よくある質問

Reddit Popular Feed APIは、Redditの r/popular フィードの投稿を、選んだ並び順と期間で取得するためのプログラムインターフェースです。各投稿のタイトルと本文、リンク、投稿者、スコア、コメント数、メディアを返します。

すべてのフィールドが任意です。空のリクエストを送ると r/popular のホットな投稿25件が返り、sort_by、published_within、results_limit で並び順、期間、件数を調整できます。

results_limit は1リクエストあたり1〜500件で、投稿1件につき0.5クレジットです。デフォルトの25件なら12.5クレジット、500件なら250クレジットになります。