reddit/
user-profile

Redditアカウントをユーザー名で一度に最大100件まで照会し、合計カルマと投稿・コメント別のカルマ、活動件数、アカウント作成日、プロフィールのフラグを返します。

Reddit User Profile API

ユーザー名を入力
カルマの内訳
アカウント歴
最大100アカウント
結果1件あたり0.5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

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行のプロフィールを読み取ります。

  1. {"usernames": ["spez", "GovSchwarzenegger"]} を /v1/reddit/user-profile に 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-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 で結果をまとめてください。

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から、番号付きのルールを短いタイトルと全文とともに取得します。

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

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

Reddit User Profile API — よくある質問

Reddit User Profile APIは、公開Redditアカウントをユーザー名で照会するためのプログラムインターフェースです。投稿・コメント別の内訳付きのカルマ、投稿数とコメント数、アカウント作成日、プロフィール情報、アカウントフラグを返します。

ユーザー名を usernames に入れ、合計は metrics.karma_count で確認します。post_karma_count と comment_karma_count を見れば、そのカルマの獲得元がわかります。

published_at にアカウントが作成された日時がISO 8601形式で入っているので、今日の日付から差し引けばアカウント歴がわかります。

返されたアカウント1件につき0.5クレジットで、100アカウントを確認すると50クレジットです。