Reddit Subreddit Details
サブレディットは、トピックごとに特化したコミュニティで、それぞれ独自のモデレーション方針、投稿者のアクティビティ、オーディエンスのリーチを持っています。サブレディットのメタデータを取得すると、コミュニティのメンバー数、週間アクティブユーザー数の推定値、コミュニティルール、アイコン画像が得られます。
Reddit Subreddit Details API の主な機能
- コミュニティの規模とエンゲージメント各サブレディットの総メンバー数、週間アクティブユーザー数、週間投稿数を抽出します。
- モデレーションルールの抽出ユーザーの参加を規定するコミュニティガイドラインと投稿ルールを、Markdown形式の全文で取得します。
- ブランディングとビジュアルアセットコミュニティのアイコン画像、ヘッダー画像、表示名、広告カテゴリの分類を取得します。
- 複数URLの一括送信/r/{subreddit} 形式のURLを配列で1回のリクエストにまとめて送信し、コミュニティを横断して分析できます。
Reddit Subreddit Details API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
urls | 必須 | メタデータを取得する公開Reddit /r/{subreddit} コミュニティURLの配列です。 |
Reddit Subreddit Details API の使い方
1件以上のサブレディットURLを非同期タスクとして送信し、ポーリングして正規化されたコミュニティプロフィールを取得します。
- https://www.reddit.com/r/technology/ のような公開サブレディットのリンクを1件以上用意します。
- urls 配列を指定して /v1/reddit/subreddit-details に POST リクエストを送信します。
- status が succeeded になるまで /v1/tasks/{task_id} をポーリングします。
- data.results.items を読み取り、正規化されたコミュニティのメタデータを取得します。
curl -X POST "https://api.socq.ai/v1/reddit/subreddit-details" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.reddit.com/r/technology/"]}'
# Poll GET /v1/tasks/{task_id}, then inspect data.results.items.Reddit Subreddit Details API の主なユースケース
- サブレディットのオーディエンス規模の把握: オーガニックなアウトリーチやAMAを始める前に、メンバー数と週間アクティブ投稿者数を評価します。
- ルール準拠のチェック: コミュニティルールをプログラムで解析し、ユーザーの投稿が投稿ポリシーに沿っているかを確認します。
- トピック別ディレクトリの構築: 分類された説明文とアイコンを含むRedditコミュニティのカタログを、常に最新の状態で維持します。
Reddit Subreddit Details API 活用のヒント
- URLは個々の投稿スレッドではなく、コミュニティのルート(例:/r/technology/)を指定してください。
- extra メタデータ内の weekly_active_users と weekly_contributions は、コミュニティの活発さを示す信頼できる指標になります。
- サブレディット名は、display_name と name の両フィールドで元の大文字・小文字のまま保持されます。
- Reddit Subreddit Postsと組み合わせると、規模の条件を満たすコミュニティから最新のコンテンツをサンプリングできます。
関連API
Reddit Subreddit Details API 以外に別の種類の公開Redditデータが必要な場合は、これらのAPIをご利用ください。
- Reddit Posts API — 対応するReddit URLから、公開投稿のテキスト、投稿者、コミュニティ情報、メディア、タイムスタンプ、表示中のエンゲージメントを取得します。
- Reddit Subreddit Posts API — サブレディットのURLから公開投稿を探します。new・top・hotの並び順とサブレディットごとの取得上限を指定でき、正規化されたコミュニティ情報とエンゲージメント情報を返します。
- Reddit Subreddit Search API
- Reddit User Profile API — ユーザー名からRedditアカウントを照会し、合計・投稿・コメント別のカルマ、活動件数、アカウント歴、プロフィールのフラグを返します。
- Reddit User Active Subreddits API — 1つのユーザー名から、Redditユーザーが活動しているサブレディットをメンバー数と説明文付きで一覧にします。
- Reddit Subreddit Rules API — サブレディットのURLから、番号付きのルールを短いタイトルと全文とともに取得します。