Reddit Subreddit Rules
Subreddit rules are the numbered posting guidelines each Reddit community sets for itself, each with a short title that moderators show in the report menu and a full explanation of what it covers. Read before posting, they tell which kinds of posts a community welcomes or removes, which supports pre-launch compliance checks, shared rulebooks for teams running several accounts and side-by-side comparisons of communities.
Reddit Subreddit Rules API Features
- Several subreddits per requesturls takes community addresses such as https://www.reddit.com/r/AskReddit/, and each subreddit comes back as one row with its r/ name and url.
- Rules in their numbered orderrules keeps the order the community uses, so the first entry is the community's first rule and a reference like "rule 3" maps straight to the third item.
- Short title and full text for each rulerules.name holds the short title moderators show in the report menu, rules.description holds the full rule text and rules.id identifies the rule.
Reddit Subreddit Rules API Parameters
| Parameters | Required | Description |
|---|---|---|
urls | Required | One or more subreddit URLs in the https://www.reddit.com/r/{name}/ form; old.reddit.com and new.reddit.com addresses work as well. |
How to Use the Reddit Subreddit Rules API
Submit subreddit URLs to the Reddit Subreddit Rules API and read one rules list per community.
- POST {"urls": ["https://www.reddit.com/r/AskReddit/"]} to /v1/reddit/subreddit-rules.
- Poll GET /v1/tasks/{task_id} until status is succeeded.
- Read each subreddit's rules array from results.items, and follow results.next_cursor while has_more is true.
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 Use Cases
- Checking a launch post against the rules: Read rules.description for each target subreddit before a product or AMA post to confirm that its format, links and wording are allowed.
- Keeping a rulebook for every community a team posts in: Store each subreddit's rules with collected_at so everyone posting from company accounts works from the same current version.
- Comparing rules across communities: Search the rules.name and rules.description fields from the Reddit Subreddit Rules API across many subreddits for terms such as promotion, links or flair to see which communities fit a campaign.
Reddit Subreddit Rules API Pro Tips
- Trim every URL to the community root /r/{name}/ before submitting, because a post link or any other path in the list rejects the whole request.
- Render rules.description as Markdown, since it keeps the lists, emphasis and links moderators wrote, including links to longer wiki versions of a rule.
- Diff rules.id and rules.description between runs to catch rules that were added, removed or rewritten before your next post goes live.
Related APIs
Beyond the Reddit Subreddit Rules API, use these APIs when you need a different type of public Reddit data.
- Reddit Posts API — Collect public post text, authors, community context, media, timestamps, and visible engagement from supported Reddit URLs.
- Reddit Subreddit Posts API — Discover public posts from subreddit URLs with new, top, or hot sorting, a per-subreddit result limit, and normalized community and engagement context.
- Reddit Subreddit Details API
- Reddit Subreddit Search API
- Reddit User Profile API — Look up Reddit accounts by username, returning total, post and comment karma, activity counts, account age and profile flags.
- Reddit User Active Subreddits API — List the subreddits a Reddit user is active in from one username, with member counts and descriptions.