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

# get_reddit

> Posts from one subreddit with title, score, comment count and text, sorted hot, new, top or rising. ₹0.28 per call; a banned or private subreddit is ₹0.

## What it does

About 25 posts from one subreddit by name (without `r/`): title, author, score, comment count, flair, created time, link and post text, in `data.posts[]`, sorted `hot` (default), `new`, `top` or `rising`. Use it to read what a community is discussing. It does not search across Reddit, does not return a post's comments, and cannot read private subreddits; for a keyword search across the web use [`search_web`](https://parel.si/docs/tools/search_web.md), for news [`search_news`](https://parel.si/docs/tools/search_news.md).

India: r/india, r/IndiaInvestments, r/bangalore and other city subreddits work well; names are case-insensitive.

## Inputs

Generated from the contract captured from staging on 2026-11-05.

| Field | Type | Required | Description |
|---|---|---|---|
| `sort` | string | no | Sort order |
| `subreddit` | string | yes | Subreddit name. e.g. "news" |

## What drives the cost

Nothing: a flat price per call of about 25 posts, around 30 KB.

## Price today

| | |
|---|---|
| Price today | **₹0.28** per call (`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_reddit"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "get_reddit"` |
| 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_reddit","input":{"sort":"hot","subreddit":"IndiaInvestments"}}'
```

## What comes back

`data.posts[]` and `data.after`, a cursor. A recorded answer from the source, trimmed to two items:

```json
{
  "success": true,
  "posts": [
    {
      "id": "1v8jytl",
      "author": "a_user_69",
      "author_fullname": "t2_16yw8g",
      "subreddit": "news",
      "title": "Javier Milei accused the Brazilian government, as well as Mexico and the US Democratic Party, of financing an \"anti-Argentina campaign.\"",
      "selftext": null,
      "selftext_html": null,
      "downs": 0,
      "name": "t3_1v8jytl",
      "upvote_ratio": 0.9347271800101988,
      "ups": 3503,
      "total_awards_received": 0,
      "score": 3503,
      "created": 1785202592,
      "created_utc": 1785202592,
      "created_at_iso": "2026-07-28T01:36:32.000Z",
      "num_comments": 536,
      "url": "https://www.batimes.com.ar/news/argentina/milei-accuses-brazil-and-mexico-of-funding-anti-argentina-campaign-without-evidence.phtml",
      "permalink": "/r/news/comments/1v8jytl/javier_milei_accused_the_brazilian_government_as/",
      "subreddit_subscribers": null,
      "is_video": false,
      "over_18": false,
      "spoiler": false,
      "domain": "batimes.com.ar",
      "subreddit_id": "t5_2qh3l",
      "post_hint": "link"
    },
    "… 2 more item(s) truncated"
  ],
  "after": "t3_1v7pwt6"
}
```

## Notes

- About 25 posts per call, around 30 KB.
- sort: hot, new, top, rising.
- A banned or private subreddit returns nothing, which is free.

## Siblings

- [`get_social_posts`](https://parel.si/docs/tools/get_social_posts.md) for an Instagram account.
- [`search_news`](https://parel.si/docs/tools/search_news.md) for the press on the same topic.
