> ## Documentation Index
> Fetch the complete documentation index at: https://docs.socq.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Reddit Subreddit Rules

> Get the posting rules of subreddits.

# 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.

```json theme={"dark"}
{
  "urls": [
    "https://www.reddit.com/r/AskReddit/"
  ]
}
```

Provide subreddit URLs in urls, such as [https://www.reddit.com/r/AskReddit/](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`.

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

The following example shows the response format for a completed task. Actual data depends on your query.

## Completed Task Response

```json theme={"dark"}
{
  "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
        }
      ]
    }
  }
}
```


## OpenAPI

````yaml api-manual/agent-api/agent-api.json POST /v1/reddit/subreddit-rules
openapi: 3.1.0
info:
  title: SocQ Agent API
  version: v1-87892a6484c2
  description: Asynchronous social data API generated from the SocQ Capability Registry.
servers:
  - url: https://api.socq.ai
security: []
paths:
  /v1/reddit/subreddit-rules:
    post:
      tags:
        - reddit
      summary: Reddit Subreddit Rules API
      description: Collect the posting rules of subreddits.
      operationId: socq_reddit_subreddit_rules
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $schema: https://json-schema.org/draft/2020-12/schema
              type: object
              additionalProperties: false
              properties:
                callback_url:
                  type: string
                  format: uri
                urls:
                  type: array
                  items:
                    type: string
                    minLength: 1
                  minItems: 1
                  description: Public profile or content URLs.
              required:
                - urls
              description: >-
                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.
      responses:
        '200':
          description: Task accepted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentSubmitResponse'
        '422':
          description: Input validation failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentValidationErrorResponse'
      security:
        - bearerAuth: []
        - apiKeyAuth: []
components:
  schemas:
    AgentSubmitResponse:
      type: object
      properties:
        code:
          type: integer
          const: 200
        data:
          type: object
          properties:
            task_id:
              type: string
            status:
              type: string
            created_time:
              type:
                - string
                - 'null'
          required:
            - task_id
            - status
    AgentValidationErrorResponse:
      type: object
      properties:
        code:
          type: integer
          const: 422
        error:
          type: object
          properties:
            message:
              type: string
            type:
              type: string
            details:
              type: object
          required:
            - message
            - type
      required:
        - code
        - error
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.