Reddit Subreddit Details

reddit_subreddit_details

Fetch a subreddit's subscribers, weekly visitors, weekly contributions, description and rules

Category: reddit•Timeout: 300s• Retryable

Input schema

POST this shape to /api/v1/tasks as the input field when creating a task in a group of type reddit_subreddit_details.

{
  "type": "object",
  "properties": {
    "subredditName": {
      "type": "string",
      "description": "The subreddit name (without r/ prefix)",
      "pattern": "^[A-Za-z0-9_]{3,21}$",
      "examples": [
        "programming",
        "ChatGPT"
      ]
    },
    "url": {
      "type": "string",
      "description": "Full subreddit URL, as an alternative to subredditName. The executor navigates to it directly and derives the name from the path.",
      "examples": [
        "https://www.reddit.com/r/programming/"
      ]
    }
  },
  "required": [],
  "anyOf": [
    {
      "required": [
        "subredditName"
      ]
    },
    {
      "required": [
        "url"
      ]
    }
  ]
}

Output schema

Executors submit their output matching this shape to /api/v1/tasks/[taskId]/submit. Readers pull it back from task detail endpoints.

{
  "type": "object",
  "properties": {
    "subreddit": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "Subreddit name without r/ prefix"
        },
        "subscribers": {
          "type": [
            "integer",
            "null"
          ],
          "description": "Subscriber (member) count — about.json `subscribers`, fetched from inside the logged-in page. null when Reddit omits it. Added in v1.3.0."
        },
        "online": {
          "type": [
            "integer",
            "null"
          ],
          "description": "Deprecated since v1.3.0: Reddit no longer publishes an online count — about.json has carried no active_user_count since at least 2026-07, and the community header shows none — so this is null in practice. Still passed through if Reddit sends active_user_count again.",
          "deprecated": true
        },
        "weeklyVisitors": {
          "type": [
            "integer",
            "null"
          ],
          "description": "Weekly visitors, exactly as the community header publishes it (the `weekly-active-users` attribute — an exact integer, not the rounded or localized display text). null when the header does not carry it. Restored in v1.3.0: desktop executors 0.6.7–0.7.4 wrongly returned null."
        },
        "weeklyContributions": {
          "type": [
            "integer",
            "null"
          ],
          "description": "Weekly contributions, exactly as the community header publishes it (the `weekly-contributions` attribute). null when the header does not carry it. Restored in v1.3.0: desktop executors 0.6.7–0.7.4 wrongly returned null."
        },
        "description": {
          "type": "string",
          "description": "Subreddit description"
        },
        "rules": {
          "type": "array",
          "description": "Subreddit rules",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "Rule identifier. Since v1.1.0 a synthetic stable id of the form rule-<n> (1-based); the legacy DOM id was an equally synthetic aria-controls value, so this remains contract-compatible."
              },
              "order": {
                "type": "integer",
                "description": "Rule order"
              },
              "title": {
                "type": "string",
                "description": "Rule title"
              },
              "description": {
                "type": "string",
                "description": "Rule description"
              }
            },
            "required": [
              "id",
              "order",
              "title",
              "description"
            ]
          }
        }
      },
      "required": [
        "name"
      ]
    }
  },
  "required": [
    "subreddit"
  ]
}

Ready to run Reddit Subreddit Details?

Create a project, approve an executor, and push your first reddit_subreddit_details task.

Get started