reddit/
subreddit-rules

The Reddit Subreddit Rules API retrieves subreddit rules from community URLs, returning each subreddit's numbered rules in order with every rule's short title and full text, several per request.

Reddit Subreddit Rules API

Subreddit URL input
Rules in order
Full rule text
0.5 credits / result
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

By SocQ · Updated

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

ParametersRequiredDescription
urlsRequiredOne 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.

  1. POST {"urls": ["https://www.reddit.com/r/AskReddit/"]} to /v1/reddit/subreddit-rules.
  2. Poll GET /v1/tasks/{task_id} until status is succeeded.
  3. 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.

Beyond the Reddit Subreddit Rules API, use these APIs when you need a different type of public Reddit data.

Explore other platforms

Combine Reddit data with public data from other supported social platforms.

Reddit Subreddit Rules API — FAQ

Reddit Subreddit Rules API is a programmatic interface for retrieving the posting rules of Reddit communities from their subreddit URLs. It returns each subreddit's rules in order, with the short title and full text of every rule.

Add the community's URL, for example https://www.reddit.com/r/AskReddit/, to urls and read the rules array of its row once the task has succeeded.

The Reddit Subreddit Rules API charges 0.5 credits for each subreddit returned, however many rules it has.