> Parel documentation. Index of every page: https://parel.si/docs/llms.txt. This page in HTML: https://parel.si/docs/tools/get_subreddit

# 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`](https://parel.si/docs/tools/get_reddit.md) or searching it with [`search_reddit`](https://parel.si/docs/tools/search_reddit.md); [`get_reddit_comments`](https://parel.si/docs/tools/get_reddit_comments.md) 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

```bash
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:

```json
{
  "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

- [`get_reddit`](https://parel.si/docs/tools/get_reddit.md)
- [`search_reddit`](https://parel.si/docs/tools/search_reddit.md)
- [`get_reddit_comments`](https://parel.si/docs/tools/get_reddit_comments.md)
