reddit/
user-posts

1つのユーザー名から、Redditユーザーが投稿した最大1000件の投稿を new・top・hot の順で取得し、タイトルと本文、正味のスコア、コメント数、メディアを返します。

Reddit User Posts API

ユーザー名を入力
new / top / hot の並び替え
最大1000件の投稿
スコアとコメント数
結果1件あたり0.5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Reddit User Posts

Redditユーザーの投稿履歴とは、アカウントがさまざまなコミュニティに投稿してきた内容の一覧で、それぞれにタイトルと本文、リンク、投稿日時、正味のスコア、コメント数、添付された画像や動画が含まれます。日付順やスコア順に読むと、その人が何を発信し、どの話題が反響を集め、発信内容が時間とともにどう変わったかがわかるため、クリエイター調査、創業者アカウントの監視、専門家による長文投稿の収集に役立ちます。

Reddit User Posts API の主な機能

  • 1つのユーザー名から最大1000件username には u/ の有無を問わず1つのアカウントを指定し、results_limit で1〜1000件(デフォルト25件)の投稿を取得できます。
  • タイトルと本文を1つの text にtext は投稿タイトルから始まり、テキスト投稿の場合は空行のあとに本文全体が続くため、1つのフィールドで投稿の文章をすべて扱えます。
  • 正味のスコアとコメント数metrics.likes_count は投稿のスコア(アップボートからダウンボートを引いた値)で、metrics.comments_count はその投稿がどれだけ議論を呼んだかを示します。
  • 画像、ギャラリー、Reddit上の動画media には添付された画像や動画がすべて url、プレビュー画像、幅と高さ(ピクセル)付きで並び、サムネイル表示やダウンロードにそのまま使えます。

Reddit User Posts API のパラメータ

パラメータ必須説明
username必須Redditユーザー名を1つ指定します(u/ の有無は問いません)。英数字、ハイフン、アンダースコアの3〜20文字です。
sort_by任意投稿の並び順です。new(デフォルト)、top、hot から選びます。
results_limit任意取得する投稿の最大件数で、1〜1000の整数です。デフォルトは25です。

Reddit User Posts API の使い方

ユーザー名を1つ、並び順と件数の上限とともに送信し、投稿をページごとに読み取ります。

  1. {"username": "spez", "sort_by": "new", "results_limit": 25} を /v1/reddit/user-posts に 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/user-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"spez","sort_by":"new","results_limit":25}'

Reddit User Posts API の主なユースケース

  • アカウントの最新投稿の追跡: sort_by を new にして定期的に実行し、published_at と url を読み取って、創業者、記者、競合のアカウントによる新しい投稿を逃さず把握します。
  • ユーザーの高スコア投稿のランキング: sort_by を top にして likes_count と comments_count を比べ、その人のどの話題や形式がもっとも強い反応を得たかを確かめます。
  • 専門家の長文投稿からのコーパス構築: テキスト投稿の text を url と published_at とともに保存し、1人の専門家による詳しい解説を集めたデータセットを作ります。

Reddit User Posts API 活用のヒント

  • タイトルと本文を分けるには、text を最初の空行で区切ってください。リンク投稿やメディア投稿にはタイトルだけが入っています。
  • sort_by を new にして新しい投稿をチェックするときは、保存済みの id を保持しておき、既知の id が現れた時点でページの読み込みを止めてください。
  • アカウントの活動全体が必要な場合は、同じユーザー名で Reddit User Comments API も実行してください。他人のスレッドへの返信はそちらで返ります。

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

  • Reddit Posts API — 対応するReddit URLから、公開投稿のテキスト、投稿者、コミュニティ情報、メディア、タイムスタンプ、表示中のエンゲージメントを取得します。
  • Reddit Comments API — 対応する投稿URLから、公開コメントのテキスト、投稿者、投稿と親コメントの参照、コミュニティ情報、タイムスタンプ、表示中のエンゲージメントを取得します。
  • Reddit Subreddit Posts API — サブレディットのURLから公開投稿を探します。new・top・hotの並び順とサブレディットごとの取得上限を指定でき、正規化されたコミュニティ情報とエンゲージメント情報を返します。
  • Reddit User Profile API — ユーザー名からRedditアカウントを照会し、合計・投稿・コメント別のカルマ、活動件数、アカウント歴、プロフィールのフラグを返します。
  • Reddit User Active Subreddits API — 1つのユーザー名から、Redditユーザーが活動しているサブレディットをメンバー数と説明文付きで一覧にします。
  • Reddit Popular Feed API — r/popular の投稿を hot・best・new・rising・top の順で、タイトルと本文、投稿者、スコア、コメント数、メディアとともに取得します。

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

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

Reddit User Posts API — よくある質問

Reddit User Posts APIは、ユーザー名を起点に、Redditアカウントが投稿した内容を取得するためのプログラムインターフェースです。各投稿のタイトルと本文、リンク、投稿日時、スコア、コメント数、添付メディアを返します。

sort_by を new、results_limit を最大1000にしてユーザー名を送信し、has_more が false になるまで next_cursor で結果をページ送りします。

new はアカウントの投稿を新しいものから順に並べ、top はスコア順に並べ、hot はそのプロフィールに対するRedditのホットランキングに従います。sort_by を省略すると new になります。

返された投稿1件につき0.5クレジットで、デフォルトの25件なら12.5クレジット、1000件なら500クレジットです。投稿数が results_limit に満たないアカウントは、返された投稿の分だけ課金されます。