Skip to content
Eden Engine

Reddit Subreddit Info Lookup (by Name)

omnial/reddit-app-fetch-subreddit-info

Given a subreddit name, returns that community's public profile: title, description text, subscriber and weekly-active-user counts, moderation/settings flags (NSFW, quarantined, posting restrictions), allowed post and comment-media types, installed moderation apps, and taxonomy topic tags.

activeper callv2

Price

Up to $0.00205 per call; you pay what the call used

You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $0.50.

Data source

Reddit

Data from Reddit.

Use it

Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.

Connect once and your AI can find and run this tool, and any other it needs.

agent
// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/reddit-app-fetch-subreddit-info" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/reddit-app-fetch-subreddit-info" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/reddit-app-fetch-subreddit-info", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/reddit-app-fetch-subreddit-info", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

ChargePrice
Per call
$0.00205
Updated
Oct 25, 2026

Input and output schemas

Input schema
input_schema.json
{
  "type": "object",
  "required": [
    "subreddit_name"
  ],
  "properties": {
    "language": {
      "type": "string",
      "default": "en-US",
      "pattern": "^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$",
      "maxLength": 16,
      "minLength": 2,
      "description": "Preferred response language as an IETF language tag; default: en-US"
    },
    "need_format": {
      "type": "boolean",
      "default": false,
      "description": "Whether to clean and format the data"
    },
    "subreddit_name": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_]+$",
      "examples": [
        "pics"
      ],
      "maxLength": 21,
      "minLength": 2,
      "description": "Subreddit name"
    }
  },
  "additionalProperties": false
}
Output schema
output_schema.json
{
  "type": "object",
  "properties": {
    "subredditInfoByName": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The subreddit's internal Reddit id, e.g. 't5_2qh0u'."
        },
        "name": {
          "type": "string",
          "description": "The subreddit's own name, without the r/ prefix."
        },
        "path": {
          "type": "string",
          "description": "e.g. '/r/pics/'."
        },
        "type": {
          "type": "string",
          "description": "e.g. 'PUBLIC'."
        },
        "wiki": {
          "type": "object",
          "properties": {
            "indexPage": {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "description": "e.g. 'VALID'."
                }
              },
              "additionalProperties": true
            }
          },
          "additionalProperties": true
        },
        "title": {
          "type": "string"
        },
        "devvit": {
          "type": "object",
          "properties": {
            "installations": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "app": {
                    "type": "object",
                    "properties": {
                      "name": {
                        "type": "string",
                        "description": "The installed app's display name."
                      },
                      "slug": {
                        "type": "string",
                        "description": "The installed app's identifier slug."
                      }
                    },
                    "additionalProperties": true
                  }
                },
                "additionalProperties": true
              }
            }
          },
          "description": "Moderation/utility bot apps this subreddit's moderators have installed.",
          "additionalProperties": true
        },
        "isNsfw": {
          "type": "boolean"
        },
        "styles": {
          "type": "object",
          "properties": {
            "primaryColor": {
              "type": "string",
              "description": "Hex color, e.g. '#553200'."
            },
            "legacyPrimaryColor": {
              "type": "string",
              "description": "Hex color, e.g. '#24A0ED'."
            }
          },
          "description": "Custom subreddit theming (colors and images). Present on full-featured subreddits such as `pics` -- absent entirely on sparser ones such as `test`, which has no custom styling configured. Image URL fields come back withheld (null); only the color values pass through.",
          "additionalProperties": true
        },
        "isMuted": {
          "type": "boolean"
        },
        "taxonomy": {
          "type": "object",
          "properties": {
            "taxonomyTopics": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "displayCopy": {
                    "type": "string",
                    "description": "A rank label, e.g. '#1 in Photography'. Present on full-featured subreddits such as `pics` -- absent on sparser ones such as `test`."
                  },
                  "taxonomyTopic": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string"
                      },
                      "displayName": {
                        "type": "string"
                      }
                    },
                    "additionalProperties": true
                  }
                },
                "additionalProperties": true
              }
            }
          },
          "additionalProperties": true
        },
        "createdAt": {
          "type": "string",
          "description": "ISO 8601 timestamp of when the subreddit was created."
        },
        "isFavorite": {
          "type": "boolean"
        },
        "activeCount": {
          "type": "number",
          "description": "Currently-online member count. Observed as `0` on every subreddit tested -- unconfirmed whether this field is ever populated by this endpoint."
        },
        "description": {
          "type": "object",
          "properties": {
            "markdown": {
              "type": "string"
            },
            "richtext": {
              "type": "string",
              "description": "The same text as a Reddit-internal JSON-encoded richtext document."
            }
          },
          "description": "The subreddit's public sidebar/rules text.",
          "additionalProperties": true
        },
        "isTitleSafe": {
          "type": "boolean"
        },
        "welcomePage": {
          "type": "object",
          "properties": {
            "isEnabled": {
              "type": "boolean"
            },
            "isEnabledOnJoin": {
              "type": "boolean"
            }
          },
          "additionalProperties": true
        },
        "isSubscribed": {
          "type": "boolean"
        },
        "isUserBanned": {
          "type": "boolean"
        },
        "prefixedName": {
          "type": "string",
          "description": "e.g. 'r/pics'."
        },
        "wikiEditMode": {
          "type": "string",
          "description": "e.g. 'MODONLY'."
        },
        "isContributor": {
          "type": "boolean"
        },
        "isQuarantined": {
          "type": "boolean"
        },
        "communityStats": {
          "type": "object",
          "properties": {
            "weeklyActiveUsersCount": {
              "type": "number"
            },
            "weeklyContributionsCount": {
              "type": "number"
            }
          },
          "additionalProperties": true
        },
        "communityStatus": {
          "type": "object",
          "properties": {
            "emoji": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string",
                  "description": "The status emoji's name, e.g. 'upvote'."
                }
              },
              "additionalProperties": true
            },
            "description": {
              "type": "object",
              "properties": {
                "markdown": {
                  "type": "string"
                },
                "richtext": {
                  "type": "string"
                }
              },
              "additionalProperties": true
            }
          },
          "description": "An optional pinned community-status banner (short status text plus an emoji). Present on full-featured subreddits such as `pics` -- absent on sparser ones such as `test`, which has none configured.",
          "additionalProperties": true
        },
        "whitelistStatus": {
          "type": "string",
          "description": "The subreddit's ad-serving tier, e.g. 'SOME_ADS', 'NO_ADS'."
        },
        "allowedPostTypes": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "detectedLanguage": {
          "type": "string",
          "description": "e.g. 'en'."
        },
        "subscribersCount": {
          "type": "number"
        },
        "isChannelsEnabled": {
          "type": "boolean"
        },
        "postFlairSettings": {
          "type": "object",
          "properties": {
            "isEnabled": {
              "type": "boolean"
            }
          },
          "additionalProperties": true
        },
        "isSpoilerAvailable": {
          "type": "boolean"
        },
        "authorFlairSettings": {
          "type": "object",
          "properties": {
            "isEnabled": {
              "type": "boolean"
            },
            "isSelfAssignable": {
              "type": "boolean"
            },
            "isOwnFlairEnabled": {
              "type": "boolean"
            }
          },
          "additionalProperties": true
        },
        "isPostingRestricted": {
          "type": "boolean"
        },
        "communityLeaderboard": {
          "type": "object",
          "properties": {
            "isEnabled": {
              "type": "boolean"
            }
          },
          "additionalProperties": true
        },
        "isCrosspostingAllowed": {
          "type": "boolean"
        },
        "publicDescriptionText": {
          "type": "string",
          "description": "Short public tagline shown next to the subreddit's name. Present on full-featured subreddits such as `pics` -- absent on sparser ones such as `test`."
        },
        "allowedMediaInComments": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "isMediaInCommentsSettingShown": {
          "type": "boolean"
        }
      },
      "additionalProperties": true
    }
  },
  "description": "The subreddit record. Fields present only on full-featured subreddits such as `pics` (community status banner, custom styling/images, and a `displayCopy` taxonomy label) are marked optional below -- a minimal or low-configuration subreddit, like `test`, omits them.",
  "additionalProperties": true
}