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つ、並び順と件数の上限とともに送信し、投稿をページごとに読み取ります。
- {"username": "spez", "sort_by": "new", "results_limit": 25} を /v1/reddit/user-posts に 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/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 も実行してください。他人のスレッドへの返信はそちらで返ります。
関連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 の順で、タイトルと本文、投稿者、スコア、コメント数、メディアとともに取得します。