Reddit Subreddit Rules API

Endpoint

GET /v1/reddit/subreddit/rules

Parameters

subreddit

Subreddit name, with or without r/, e.g. Python. Provide exactly one of subreddit or url.

url

Subreddit URL, e.g. https://www.reddit.com/r/Python/ (max 500 characters). Provide exactly one of subreddit or url.

Response fields

rules

The subreddit's rules, in order

priority

Position in the rules list, starting at 0

title

Rule title

description

Rule text (Markdown)

applies_to

What the rule covers: link (posts), comment or all

violation_reason

Reason shown when content is reported under the rule

created_at

When the rule was added (UTC)

subreddit

The subreddit name

count

Number of rules returned

Example Request

curl "https://apidirect.io/v1/reddit/subreddit/rules?subreddit=Python" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

response = requests.get(
    "https://apidirect.io/v1/reddit/subreddit/rules",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={
        "subreddit": "Python"
    }
)
print(response.json())

Example Response

{
  "rules": [
    {
      "priority": 0,
      "title": "No showcase posts",
      "description": "Due to an increase of showcases featuring AI content such as working with multiple AI models or wrappers around APIs, this is no longer allowed. Please post...",
      "applies_to": "link",
      "violation_reason": "No showcase posts",
      "created_at": "2024-08-03 05:47:33"
    }
  ],
  "subreddit": "Python",
  "count": 11
}

Frequently asked questions

What does applies_to mean?

link for rules about posts, comment for rules about comments, all for both.

How does pricing work?

You only pay for successful requests. The Reddit Subreddit Rules API costs $0.003 per request. There are no monthly fees or commitments. You get 50 free requests per endpoint every month.

Do I need a credit card to start?

No. You can sign up and use the free tier (50 requests/endpoint/month) without adding a payment method. You only need to add a card when you want to exceed the free tier.

Are there rate limits?

Yes, there's a concurrency limit of 10 simultaneous requests per endpoint per user. If you need more, just get in touch.