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.

FieldTypeRequiredDescription
urlstringone ofThe subreddit URL, instead of the name.
subredditstringone ofThe 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 whenit fails, or the provider answers but there is nothing in it (an empty list, no email, no page): class: "ok_free", ₹0
Timeout30 s, then upstream_timeout (₹0, retryable)
Over MCPrun_tool with tool: "get_subreddit"
Over RESTPOST https://api.parel.si/v1/run with "tool": "get_subreddit"
Confirmationnot 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.