Subreddit Rules API
Get a subreddit's posting rules with descriptions and removal reasons. $0.01 per call.
Fetch the rules of any public subreddit in order. Each rule includes its priority, title, full description, the violation reason moderators use when removing content, and whether it applies to posts, comments, or both.
Try it live
Fill in the fields and hit Run to see a real response.
{
"ok": true,
"data": {
"rules": [
{
"applies_to": "link",
"description": "* All questions must be clear, written in English, and conclude with a question mark\n* All context in the title must be ***necessary to understanding the question***; do not give “example answers” in …",
"priority": 0,
"title": "Rule 1 - Questions must be clear and direct and may not use the body textbox",
"violation_reason": "Rule 1 - Questions must be clear and direct and may not use the body textbox"
}
]
}
}Features
Rules come back with their priority, so you can show them in the same order the subreddit does.
Each rule includes the complete description text, not just the short title.
violation_reason shows the label moderators use when removing content for that rule.
applies_to tells you whether a rule covers posts, comments, or both.
Rules rarely change, so responses are cached for a day.
Use cases
Pre-posting Checks
Show users a community's rules before they submit, to avoid removals.
Marketing Compliance
Check which communities allow self-promotion before outreach.
Moderation Assistants
Give an AI moderator the exact rules it should enforce.
Quick start
Copy this snippet and start making calls.
const res = await fetch('https://api.yepapi.com/v1/reddit/subreddit-rules', {
method: 'POST',
headers: {
'x-api-key': 'YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({
"subreddit": "AskReddit"
}),
});
const data = await res.json();
console.log(data);The Subreddit Rules API for posting guidelines as data
The YepAPI Subreddit Rules API returns a community's rules as structured data. Send a subreddit to /v1/reddit/subreddit-rules and get each rule's priority, title, full description, violation reason, and scope, at $0.01 per call.
Rules decide whether a post survives. Reading them programmatically lets your app warn users, filter target communities, or brief an AI moderator before anything goes live.
What does the Subreddit Rules API return?
A rules array. Each rule has priority, title, description, violation_reason, and applies_to (for example link, comment, or all). The description is the full rule text the community wrote.
Build rule-aware posting and outreach
Before a scheduling tool submits to a subreddit, call /v1/reddit/subreddit-rules and show the rules next to the draft. Marketing teams can scan rules across a list of communities to find the ones that allow self-promotion, and moderation tools can pass the rules to an AI model as its policy.
Subreddit Rules API pricing: $0.01 per call
Every call costs a flat $0.01 and failed calls are free. There is no monthly minimum, no seat fee, and no Reddit app to register: you only need a YepAPI key. Rules are cached for 24 hours.
Works with the Subreddit API
The Subreddit API tells you what content types a community allows (links, images, videos, polls). The Rules API tells you what it allows in words. Use both before posting.
Try the Subreddit Rules API free
Sign up and get $5 in free credit with no card required. That is 500 calls at $0.01 each to test the Subreddit Rules API against live Reddit data before you spend anything. The rest of the Reddit API is on the same key.
Start making API calls in 30 seconds
$5 free credit on signup. No credit card required. Pay per call.
What developers say
“Switched from SerpAPI and cut our SERP costs by 80%. Same data quality, way simpler billing.”
“One API key for AI models, SERP data, and web scraping. Saved us from managing 4 separate providers.”
“The $5 free credit let us prototype our entire rank tracking feature before committing. No other API does that.”
Frequently asked questions
Fetch the rules of any public subreddit in order. Each rule includes its priority, title, full description, the violation reason moderators use when removing content, and whether it applies to posts, comments, or both.
Each API call costs $0.01. No monthly minimums or subscriptions — you only pay for what you use.
Sign up for a free API key, then send a POST request to /v1/reddit/subreddit-rules. Check the code example above for a ready-to-use snippet in JavaScript, cURL, or Python.
YepAPI bundles SEO, AI, and web scraping APIs under one key with no monthly minimums. You get lower per-call pricing, a unified dashboard, and one billing account instead of managing multiple providers.
Ready to integrate?
Get your API key and start making calls in 30 seconds. $5 free credit on signup — no credit card required.
More Reddit API endpoints
Similar Subreddits API
$0.01Find subreddits related to any community, with subscriber counts and descriptions. $0.01 per call.
Subreddit API
$0.01Get any subreddit's subscribers, description, sidebar, settings, and branding as JSON. $0.01 per call.
Subreddit Posts API
$0.01Pull hot, new, top, or controversial posts from any subreddit as JSON. A subreddit scraper at $0.01 per call.
Subreddit Comments API
$0.01Stream the latest comments posted anywhere in a subreddit, with post context. $0.01 per call.
Reddit Post API
$0.01Get any Reddit post by URL: title, body, score, comment count, flair, and media. $0.01 per call.
Reddit Comments API
$0.01Get the full comment tree of any Reddit post with nested replies. A Reddit comment scraper at $0.01 per call.