reddit/
subreddit-details

コミュニティURLから公開サブレディットのメタデータを取得し、メンバー数、週間アクティブユーザー数、ルール、コミュニティのアセットを返します。

Reddit Subreddit Details API

サブレディットのメタデータ
コミュニティ規模の把握
モデレーションルール
結果1件あたり0.5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

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を非同期タスクとして送信し、ポーリングして正規化されたコミュニティプロフィールを取得します。

  1. https://www.reddit.com/r/technology/ のような公開サブレディットのリンクを1件以上用意します。
  2. urls 配列を指定して /v1/reddit/subreddit-details に POST リクエストを送信します。
  3. status が succeeded になるまで /v1/tasks/{task_id} をポーリングします。
  4. 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と組み合わせると、規模の条件を満たすコミュニティから最新のコンテンツをサンプリングできます。

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

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

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

Reddit Subreddit Details API — よくある質問

Reddit Subreddit Details APIは、標準的なサブレディットURLからRedditコミュニティの公開メタデータを包括的に取得するAPIです。メンバー数、週間アクティブ参加者数、モデレーションルール、コミュニティのブランディングアセットを提供します。

必要ありません。すべてのリクエストはSocQのAPIキーで認証されるため、Redditアプリの登録やユーザー認可は不要です。

できます。urls パラメータにURLの配列を渡すと、タスクが公開コミュニティごとにメタデータを取得して返します。