Reddit Subreddit Rules
サブレディットのルールは、Redditの各コミュニティが自ら定める番号付きの投稿ガイドラインで、モデレーターが報告メニューに表示する短いタイトルと、対象範囲を説明する全文で構成されます。投稿前に読めばそのコミュニティで歓迎される投稿と削除される投稿がわかり、公開前のルール確認、複数アカウントを運用するチームの共通ルールブック作り、コミュニティ同士の比較に役立ちます。
Reddit Subreddit Rules API の主な機能
- 1回のリクエストで複数のサブレディットurls には https://www.reddit.com/r/AskReddit/ のようなコミュニティのアドレスを指定し、各サブレディットが r/ 形式の名前と url を持つ1行として返ります。
- 番号どおりの順序のルールrules はコミュニティが使っている順序を保つため、最初の要素がそのコミュニティのルール1にあたり、「ルール3」といった言及も3番目の要素にそのまま対応します。
- ルールごとの短いタイトルと全文rules.name にはモデレーターが報告メニューに表示する短いタイトル、rules.description にはルールの全文が入り、rules.id でルールを識別できます。
Reddit Subreddit Rules API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
urls | 必須 | https://www.reddit.com/r/{name}/ 形式のサブレディットURLを1つ以上指定します。old.reddit.com や new.reddit.com のアドレスも使えます。 |
Reddit Subreddit Rules API の使い方
サブレディットのURLを送信し、コミュニティごとに1つのルール一覧を読み取ります。
- {"urls": ["https://www.reddit.com/r/AskReddit/"]} を /v1/reddit/subreddit-rules に POST します。
- status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
- results.items から各サブレディットの rules 配列を読み取り、has_more が true の間は results.next_cursor をたどります。
curl -X POST "https://api.socq.ai/v1/reddit/subreddit-rules" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.reddit.com/r/AskReddit/"]}'Reddit Subreddit Rules API の主なユースケース
- 告知投稿のルール適合チェック: 製品の告知やAMAを投稿する前に、対象サブレディットごとの rules.description を読み、形式、リンク、言い回しが認められているかを確かめます。
- チームが投稿する全コミュニティのルールブック管理: 各サブレディットのルールを collected_at とともに保存し、会社のアカウントから投稿するメンバー全員が同じ最新版を参照できるようにします。
- コミュニティ間のルール比較: 多数のサブレディットの rules.name と rules.description から宣伝、リンク、フレアといった語を検索し、キャンペーンに合うコミュニティを見極めます。
Reddit Subreddit Rules API 活用のヒント
- 送信前にすべてのURLをコミュニティのルート /r/{name}/ まで切り詰めてください。投稿リンクなど別のパスが1つでも含まれると、リクエスト全体が拒否されます。
- rules.description はモデレーターが書いたリスト、強調、リンク(ルールの詳しいWiki版へのリンクを含む)を保持しているため、Markdownとして表示してください。
- 実行ごとに rules.id と rules.description の差分を取り、次の投稿を公開する前に追加・削除・書き換えられたルールを把握してください。
関連API
Reddit Subreddit Rules API 以外に別の種類の公開Redditデータが必要な場合は、これらのAPIをご利用ください。
- Reddit Posts API — 対応するReddit URLから、公開投稿のテキスト、投稿者、コミュニティ情報、メディア、タイムスタンプ、表示中のエンゲージメントを取得します。
- Reddit Subreddit Posts API — サブレディットのURLから公開投稿を探します。new・top・hotの並び順とサブレディットごとの取得上限を指定でき、正規化されたコミュニティ情報とエンゲージメント情報を返します。
- Reddit Subreddit Details API
- Reddit Subreddit Search API
- Reddit User Profile API — ユーザー名からRedditアカウントを照会し、合計・投稿・コメント別のカルマ、活動件数、アカウント歴、プロフィールのフラグを返します。
- Reddit User Active Subreddits API — 1つのユーザー名から、Redditユーザーが活動しているサブレディットをメンバー数と説明文付きで一覧にします。