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 の使い方
並び順と件数の上限を選ぶか、空のボディを送信して、フィードをページごとに読み取ります。
- {"sort_by": "hot", "results_limit": 25} を /v1/reddit/popular-feed に POST します。
- status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
- 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 に送り、カルマやアカウント歴を確認してください。
関連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の検索結果へのリンクを返します。