Reddit User Profile
Redditのユーザープロフィールは u/ から始まる名前の公開アカウントページで、投稿とコメントに分かれた合計カルマ、これまでの投稿数とコメント数、作成日、プロフィール文、アバター、トロフィー、認証済みアカウントやRedditスタッフを示すバッジが表示されます。これらのシグナルを組み合わせるとアカウントの実績と活動量がわかるため、クリエイターの見極め、新規アカウントや低カルマアカウントのチェック、特定ジャンルの影響力あるメンバーの継続的な追跡に役立ちます。
Reddit User Profile API の主な機能
- 1回のリクエストで最大100ユーザー名usernames には u/ の有無を問わず最大100件のRedditユーザー名を指定でき、存在するアカウントはそれぞれ1行として返ります。
- 獲得元別のカルマmetrics.karma_count が合計カルマを示し、post_karma_count と comment_karma_count で投稿とコメントのどちらで得たカルマかがわかります。
- 活動件数とアカウント歴posts_count と comments_count でアカウントの貢献量を測れ、published_at にはアカウントが作成された日時が入ります。
- プロフィールのバッジとトロフィーis_verified、is_employee、is_nsfw はRedditが付けるアカウントフラグで、trophies_count はトロフィーの数を示します。表示名、プロフィール文、アバター、バナーもあわせて返ります。
Reddit User Profile API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
usernames | 必須 | Redditユーザー名を最大100件指定します(u/ の有無は問いません)。各名前は英数字、ハイフン、アンダースコアの3〜20文字です。 |
Reddit User Profile API の使い方
Redditユーザー名のリストを送信し、存在するアカウントごとに1行のプロフィールを読み取ります。
- {"usernames": ["spez", "GovSchwarzenegger"]} を /v1/reddit/user-profile に 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-profile" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["spez","GovSchwarzenegger"]}'Reddit User Profile API の主なユースケース
- 連絡前のクリエイター確認: karma_count、posts_count、published_at を確認し、コンタクト予定のRedditユーザーに長く活発な活動歴があるかを確かめます。
- 新規・低カルマアカウントの洗い出し: 似た投稿やコメントが一斉に現れたときに投稿者を調べ、published_at が新しく karma_count が低いユーザー名に印を付けます。
- 注目アカウントの定点観測: 同じユーザー名を定期的に再取得して karma_count、posts_count、followers_count を比べ、伸びているメンバーを把握します。
- Redditハンドル一覧の情報補完: スレッドから集めたユーザー名に表示名、プロフィール文、avatar_url、プロフィールの url を加え、スプレッドシートやCRMで各人物がわかるようにします。
Reddit User Profile API 活用のヒント
- 送信前にユーザー名を整えてください。u/ を除いた部分は英数字、ハイフン、アンダースコアの3〜20文字である必要があり、形式に合わない名前が1つでもあるとリクエスト全体が拒否されます。
- 大文字・小文字だけが異なる同じ名前は1回だけ照会され1行で返るため、入力との突き合わせは小文字にしたユーザー名で行ってください。
- 100件を超えるリストは100件ずつに分けて送り、アカウントの不変のRedditの識別子である id で結果をまとめてください。
関連API
Reddit User Profile API 以外に別の種類の公開Redditデータが必要な場合は、これらのAPIをご利用ください。
- Reddit Posts API — 対応するReddit URLから、公開投稿のテキスト、投稿者、コミュニティ情報、メディア、タイムスタンプ、表示中のエンゲージメントを取得します。
- Reddit Subreddit Details API
- Reddit User Posts API — 1つのユーザー名から、Redditユーザーの投稿履歴を new・top・hot の順で、タイトルと本文、スコア、コメント数、メディアとともに取得します。
- Reddit User Comments API — 1つのユーザー名から、Redditユーザーのコメント履歴を300文字の抜粋、スコア、コメントのリンク、投稿IDとともに取得します。
- Reddit User Active Subreddits API — 1つのユーザー名から、Redditユーザーが活動しているサブレディットをメンバー数と説明文付きで一覧にします。
- Reddit Subreddit Rules API — サブレディットのURLから、番号付きのルールを短いタイトルと全文とともに取得します。