Reddit User Active Subreddits
Redditユーザーのアクティブなサブレディットとは、アカウントが最近投稿やコメントをしたコミュニティのことで、r/ 形式の名前、リンク、メンバー数、コミュニティ自身による説明文とともに一覧になります。このリストからその人がRedditのどこで時間を過ごしているかがわかり、関心分野のプロファイリング、オーディエンスが集まるニッチなコミュニティの発見、次に傾聴や参加をする場所の選定に役立ちます。
Reddit User Active Subreddits API の主な機能
- ユーザー名1つでアクティブな一覧全体username には u/ の有無を問わず1つのアカウントを指定し、1回のリクエストでそのアカウントのアクティブ一覧にあるコミュニティをすべて返します。
- コミュニティ名とアドレス各行の username にはサブレディットの素の名前、name には r/ 形式の名前、url にはアドレスが入り、そのまま開いたりほかのReddit照会に渡したりできます。
- メンバー数と説明文metrics.followers_count はメンバー数、text はコミュニティ自身の説明文で、各サブレディットの規模と扱うテーマがわかります。
Reddit User Active Subreddits API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
username | 必須 | Redditユーザー名を1つ指定します(u/ の有無は問いません)。英数字、ハイフン、アンダースコアの3〜20文字です。 |
Reddit User Active Subreddits API の使い方
ユーザー名を1つ送信し、そのアカウントが活動しているコミュニティを読み取ります。
- {"username": "GovSchwarzenegger"} を /v1/reddit/user-active-subreddits に 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-active-subreddits" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username":"GovSchwarzenegger"}'Reddit User Active Subreddits API の主なユースケース
- 人物の関心分野のプロファイリング: インフルエンサーや見込み客が活動している各コミュニティの name と text を読み、その人が追っている話題、趣味、職業を把握します。
- オーディエンスが共有するニッチなコミュニティの発見: 既存顧客数人のアクティブ一覧を集めて各 id の出現回数を数え、followers_count で小規模な共通サブレディットと一般的なものを見分けます。
- 傾聴・参加先の選定: followers_count と text が自社のテーマにどれだけ合うかでコミュニティを並べ、次に監視や投稿をする価値のあるサブレディットを選びます。
Reddit User Active Subreddits API 活用のヒント
- ここで見つけたコミュニティに投稿する前に url を Reddit Subreddit Rules API に渡し、最近のスレッドを確認するには Reddit Subreddit Posts API に渡してください。
- 一覧は最近の活動を反映し、本人がコミュニティを移るにつれて変わるため、同じユーザー名をときどき再実行して前回の一覧と id を比べてください。
関連API
Reddit User Active Subreddits API 以外に別の種類の公開Redditデータが必要な場合は、これらのAPIをご利用ください。
- Reddit Posts API — 対応するReddit URLから、公開投稿のテキスト、投稿者、コミュニティ情報、メディア、タイムスタンプ、表示中のエンゲージメントを取得します。
- Reddit Comments API — 対応する投稿URLから、公開コメントのテキスト、投稿者、投稿と親コメントの参照、コミュニティ情報、タイムスタンプ、表示中のエンゲージメントを取得します。
- Reddit Subreddit Posts API — サブレディットのURLから公開投稿を探します。new・top・hotの並び順とサブレディットごとの取得上限を指定でき、正規化されたコミュニティ情報とエンゲージメント情報を返します。
- Reddit Subreddit Details API
- Reddit User Profile API — ユーザー名からRedditアカウントを照会し、合計・投稿・コメント別のカルマ、活動件数、アカウント歴、プロフィールのフラグを返します。
- Reddit Subreddit Rules API — サブレディットのURLから、番号付きのルールを短いタイトルと全文とともに取得します。