get_subreddit
A subreddit's details: description, subscribers, active users, rules, creation date and flags. ₹0.28 per subreddit; a result that finds nothing is ₹0.
What it does
The details of one subreddit from its name or url: data with the title, description, subscriber count, active user count, creation date, rules and whether it is NSFW or quarantined.
Use it to size a community before reading it with get_reddit or searching it with search_reddit; get_reddit_comments reads one post's discussion. The name is case sensitive (IndianSkincareAddicts). Flat price per call; a subreddit that does not exist, or is private or banned, answers nothing, which is free. Under two seconds.
India: Indian subreddits (r/india, r/IndianSkincareAddicts, r/IndiaInvestments) are active and public.
Inputs
Generated from the contract captured from staging on 2026-11-05.
| Field | Type | Required | Description |
|---|---|---|---|
url | string | one of | The subreddit URL, instead of the name. |
subreddit | string | one of | The subreddit name, case sensitive ("IndianSkincareAddicts"). |
One of these sets must be complete (anything else is invalid_input, ₹0): subreddit; url.
What drives the cost
Flat per call; an unknown, private or banned subreddit is free. A result that finds nothing is class: "ok_free", ₹0. The timeout is 30 seconds.
Price today
| Price today | ₹0.28 per subreddit (cost_paise: 28) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹0.42 (hold_paise: 42); when the call settles the real price is charged and the unused part is released |
| ₹0 when | it fails, or the provider answers but there is nothing in it (an empty list, no email, no page): class: "ok_free", ₹0 |
| Timeout | 30 s, then upstream_timeout (₹0, retryable) |
| Over MCP | run_tool with tool: "get_subreddit" |
| Over REST | POST https://api.parel.si/v1/run with "tool": "get_subreddit" |
| Confirmation | not needed (the estimate is under the ₹200 threshold) |
Request
curl https://api.parel.si/v1/run \
-H "Authorization: Bearer $PAREL_KEY" \
-H "Content-Type: application/json" \
-d '{"tool":"get_subreddit","input":{"subreddit":"IndianSkincareAddicts"}}'
What comes back
data, as the live check of 2026-11-05 recorded it, trimmed:
{
"subreddit_id": "t5_gx07z",
"display_name": "IndianSkincareAddicts",
"weekly_active_users": 242350,
"weekly_contributions": 2778,
"rules": "1 Be mindful of your behaviour. Follow Redditquette. Be respectful and kind. Follow Reddit sitewide policies. Hurtful/hateful comments on race, weight, sex, age, colour, caste, or socio-economic background, homophobia, misogyny, misandry, r…",
"description": "A space for Indians to discuss their varied experiences with beauty, with a strong emphasis on science. Our mission will be to explore international offerings as well as our equally effective desi products, particularly those found at our e…",
"header_img": "https://styles.redditmedia.com/t5_gx07z/styles/bannerBackgroundImage_hdl9x2c4ghs51.png",
"icon_img": "https://styles.redditmedia.com/t5_gx07z/styles/communityIcon_7vmdzxnh7ty51.png",
"subscribers": null,
"advertiser_category": "",
"created_at": "2018-03-16T08:50:09.890Z",
"submit_text": ""
}
Notes
- Flat per call; an unknown, private or banned subreddit is free.
- The name is case sensitive: IndianSkincareAddicts, not indianskincareaddicts.
- Pairs with get_reddit for the posts and search_reddit for a keyword.
Siblings
This page as Markdown: /docs/tools/get_subreddit.md. Something wrong or missing: hello@parel.si.