Reddit Subreddit Rules API
curl --request POST \
--url https://api.socq.ai/v1/reddit/subreddit-rules \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"urls": [
"<string>"
],
"callback_url": "<string>"
}
'import requests
url = "https://api.socq.ai/v1/reddit/subreddit-rules"
payload = {
"urls": ["<string>"],
"callback_url": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({urls: ['<string>'], callback_url: '<string>'})
};
fetch('https://api.socq.ai/v1/reddit/subreddit-rules', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.socq.ai/v1/reddit/subreddit-rules",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'urls' => [
'<string>'
],
'callback_url' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.socq.ai/v1/reddit/subreddit-rules"
payload := strings.NewReader("{\n \"urls\": [\n \"<string>\"\n ],\n \"callback_url\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.socq.ai/v1/reddit/subreddit-rules")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"urls\": [\n \"<string>\"\n ],\n \"callback_url\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.socq.ai/v1/reddit/subreddit-rules")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"urls\": [\n \"<string>\"\n ],\n \"callback_url\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"code": 200,
"data": {
"task_id": "<string>",
"status": "<string>",
"created_time": "<string>"
}
}{
"code": 422,
"error": {
"message": "<string>",
"type": "<string>",
"details": {}
}
}Reddit
Reddit Subreddit Rules
Get the posting rules of subreddits.
POST
/
v1
/
reddit
/
subreddit-rules
Reddit Subreddit Rules API
curl --request POST \
--url https://api.socq.ai/v1/reddit/subreddit-rules \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"urls": [
"<string>"
],
"callback_url": "<string>"
}
'import requests
url = "https://api.socq.ai/v1/reddit/subreddit-rules"
payload = {
"urls": ["<string>"],
"callback_url": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({urls: ['<string>'], callback_url: '<string>'})
};
fetch('https://api.socq.ai/v1/reddit/subreddit-rules', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.socq.ai/v1/reddit/subreddit-rules",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'urls' => [
'<string>'
],
'callback_url' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.socq.ai/v1/reddit/subreddit-rules"
payload := strings.NewReader("{\n \"urls\": [\n \"<string>\"\n ],\n \"callback_url\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.socq.ai/v1/reddit/subreddit-rules")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"urls\": [\n \"<string>\"\n ],\n \"callback_url\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.socq.ai/v1/reddit/subreddit-rules")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"urls\": [\n \"<string>\"\n ],\n \"callback_url\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"code": 200,
"data": {
"task_id": "<string>",
"status": "<string>",
"created_time": "<string>"
}
}{
"code": 422,
"error": {
"message": "<string>",
"type": "<string>",
"details": {}
}
}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.{
"urls": [
"https://www.reddit.com/r/AskReddit/"
]
}
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, usefields for MCP queries, _result_fields for typed tools, or --result-fields in the CLI. Declared fields remain present when their value is null.
| Field | Type | Nullable | Description |
|---|---|---|---|
id | string | Yes | Unique identifier for this result item. |
platform | string | No | Platform the result belongs to, such as instagram or linkedin. |
resource | string | No | SocQ resource represented by the result, such as videos or comments. |
type | string | No | Category of the result item, such as video, post, or comment. |
url | string | Yes | Public URL of the result item when available. |
published_at | string | Yes | Time the source item was published, in ISO 8601 format when available. |
collected_at | string | No | Time SocQ collected or processed this result, in ISO 8601 format. |
name | string | Yes | Display name of the result item. |
text | string | Yes | Primary text associated with the result item. |
cover_url | string | Yes | URL of the cover image. |
author | object | Yes | Author or publisher of the content. |
author.id | string | Yes | Unique identifier of the author. |
author.username | string | Yes | Public username or handle of the account. |
author.name | string | Yes | Display name of the author. |
author.url | string | Yes | Public URL of the author when available. |
author.avatar_url | string | Yes | URL of the account avatar image. |
author.is_verified | boolean | Yes | Whether the account is verified on the platform. |
author.is_private | boolean | Yes | Whether the account is private. |
metrics | object | Yes | Counters and measurements available for the result item. |
metrics.members_count | integer | Yes | Number of community members. |
metrics.moderators_count | integer | Yes | Number of community moderators. |
rules | array<object> | Yes | Public community rules. |
rules.id | string | Yes | Unique identifier of the referenced object. |
rules.name | string | Yes | Display name of the referenced object. |
rules.description | string | Yes | Description of the community rule. |
join_policy | string | Yes | Policy for joining this community. |
invites_policy | string | Yes | Policy for inviting members to this community. |
is_nsfw | boolean | Yes | Whether the community is marked as sensitive content. |
Completed Task Response
{
"code": 200,
"data": {
"task_id": "example-reddit-subreddit-rules",
"status": "succeeded",
"public_id": "reddit/subreddit-rules",
"result_count": 1,
"credits_amount": 0.5,
"results": {
"limit": 50,
"next_cursor": null,
"has_more": false,
"schema_id": "community",
"schema_version": "1.0",
"items": [
{
"id": "t5_2qh1i",
"platform": "reddit",
"resource": "subreddit-rules",
"type": "subreddit",
"url": "https://www.reddit.com/r/AskReddit/",
"published_at": null,
"collected_at": "2026-11-17T14:40:40.044923Z",
"name": "r/AskReddit",
"text": null,
"cover_url": null,
"author": null,
"metrics": null,
"rules": [
{
"id": "208a1822-d194-454d-b1f7-879a6f1ebc4d",
"name": "Rule 1 - Questions must be clear and direct and may not use the body textbox",
"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 the post title (i.e. “Other than your mom, \\_\\_\\_\\_\\_\\_?”)\n* No text in the text box - any additional info from you must be added as a comment to your post\n\n[The full rule can be viewed here](https://www.reddit.com/r/AskReddit/wiki/index/#wiki_rule_1)"
},
{
"id": "8ad86724-82cb-4ffc-bced-6a659e573e54",
"name": "Rule 2 - No personal or professional advice requests",
"description": "* Askreddit is NOT your personal or professional advice platform\n\n* Do not makes posts asking for professional advice - medical, legal, financial, or otherwise\n\n* All posts asking for advice must be generic and not specific to your situation alone\n\n* Do not use first person pronouns\n\n* No crowdsourcing naming or purchasing decisions\n\n[The full rule can be viewed here](https://www.reddit.com/r/AskReddit/wiki/index/#wiki_rule_2)"
},
{
"id": "0f52d096-cb78-48fe-ab63-3c996c66a5e1",
"name": "Rule 3 - Open ended questions only",
"description": "* Post must be an open-ended discussion question\n\n* Title must not be phrased to allow a simple yes/no answer\n\n* No questions that have definite answers\n\n* Question must not be a poll or survey\n\n* No “Either/Or” type questions\n\n* Do not ask for NSFW links\n\n* Do not specify a length (eg \"in three words...\") or make your post into a game\n\n[The full rule can be viewed here](https://www.reddit.com/r/AskReddit/wiki/index/#wiki_rule_3)"
}
],
"join_policy": null,
"invites_policy": null,
"is_nsfw": null
}
]
}
}
}
Authorizations
bearerAuthapiKeyAuth
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.

