reddit/
subreddit-rules

コミュニティのURLからサブレディットのルールを取得し、各サブレディットの番号付きルールを順番どおりに、ルールごとの短いタイトルと全文とともに返します。1回のリクエストで複数指定できます。

Reddit Subreddit Rules API

サブレディットURLを入力
番号順のルール
ルールの全文
結果1件あたり0.5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

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つのルール一覧を読み取ります。

  1. {"urls": ["https://www.reddit.com/r/AskReddit/"]} を /v1/reddit/subreddit-rules に POST します。
  2. status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
  3. 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 の差分を取り、次の投稿を公開する前に追加・削除・書き換えられたルールを把握してください。

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ユーザーが活動しているサブレディットをメンバー数と説明文付きで一覧にします。

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

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

Reddit Subreddit Rules API — よくある質問

Reddit Subreddit Rules APIは、サブレディットのURLからRedditコミュニティの投稿ルールを取得するためのプログラムインターフェースです。各サブレディットのルールを順番どおりに、すべてのルールの短いタイトルと全文とともに返します。

https://www.reddit.com/r/AskReddit/ のようなコミュニティのURLを urls に追加し、タスクが成功したらその行の rules 配列を読み取ります。

ルールの数にかかわらず、返されたサブレディット1件につき0.5クレジットです。