Skip to main content
POST
Reddit Subreddit Rules API

Reddit Subreddit Rules

Read a subreddit’s rules before you post there. Each subreddit comes back as one row with its numbered rules in order, each with the short title moderators show in the report menu and the full rule text. Brands and community managers use it to check what is allowed before a launch post, and teams running many accounts use it to keep a rulebook for every community they take part in.
Provide subreddit URLs in urls, such as https://www.reddit.com/r/AskReddit/. Each subreddit returns one row with its numbered rules and costs 0.5 credits.

Standard Result Fields

Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, use fields for MCP queries, _result_fields for typed tools, or --result-fields in the CLI. Declared fields remain present when their value is null. The following example shows the response format for a completed task. Actual data depends on your query.

Completed Task Response

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Provide subreddit URLs in urls, such as https://www.reddit.com/r/AskReddit/. Each subreddit returns one row with its numbered rules, each with a short title and the full rule text.

urls
string[]
required

Public profile or content URLs.

Minimum array length: 1
Minimum string length: 1
callback_url
string<uri>

Response

Task accepted

code
integer
data
object