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

# search_reddit

> Posts across all of Reddit about a query, by relevance, newest, top or comment count. ₹0.28 per page; no matches is ₹0.

## What it does

Posts from across Reddit matching `query`, in `data.posts[]`: `title`, `subreddit`, `author`, `score`, `upvote_ratio`, `num_comments`, `created_at_iso`, `url`, `permalink` and `selftext`, with `data.after` for the next page. `sort` `relevance` (default), `new`, `top` or `comment_count`; `timeframe` `day`, `week`, `month`, `year` or `all`; `filter: "comments"` searches comments instead. Use it to find what people say about a brand or a problem across communities; for one subreddit's feed [`get_reddit`](https://parel.si/docs/tools/get_reddit.md).

India: add the market to the query ("mamaearth india") or search an Indian subreddit by name.

## Inputs

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

| Field | Type | Required | Description |
|---|---|---|---|
| `sort` | `relevance` or `new` or `top` or `comment_count` | no | Prefer relevance when you want posts matching the query. One of: relevance \| new \| top \| comment_count. sort=new is chronological newest-first and often returns weakly related or unrelated sitewide posts (not "recent posts about X"). Brand/token queries may also match colloquial substrings under new. Comment search supports relevance, new, and top; comment_count is for post search only.. e.g. "relevance" |
| `trim` | boolean | no | Set to true for a trimmed down version of the response. e.g. false |
| `after` | string | no | Pagination token from the previous response (after) to get the next page |
| `query` | string | yes | Search query. e.g. "ai" |
| `filter` | `posts` or `comments` | no | Search posts or comments. Default posts.. e.g. "posts" |
| `timeframe` | `all` or `day` or `week` or `month` or `year` | no | Post search timeframe. One of: all \| day \| week \| month \| year.. e.g. "all" |

## What drives the cost

Nothing: flat per page. No matches is `class: "ok_free"`, ₹0. Usually five to seven seconds.

## Price today

| | |
|---|---|
| Price today | **₹0.28** per page (`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: "search_reddit"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "search_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":"search_reddit","input":{"sort":"relevance","query":"mamaearth","timeframe":"month"}}'
```

## What comes back

`data.posts[]` and `data.after`. A real answer recorded during the live check of 2026-10-28, trimmed to two posts:

```json
{
  "success": true,
  "posts": [
    {
      "id": "1x1g7s0",
      "post_id": "t3_1x1g7s0",
      "author": "a_user_74",
      "author_fullname": "t2_utkwaep1t",
      "subreddit": "India_Parenting",
      "title": "Is mamaearth mosquito repellent patches for babies worth it?",
      "selftext": "My uncle has a 1 month old baby and our house faces mosquito problems in the rainy season. It's an old style tiled house so mosquito netting on doors and windows wont work since mosquitos will come through the roof. So I bought a mamaearth mosquito repellent patch for babies for the baby. Just wanna know whether it'll work enough to make the baby sleep peace…",
      "selftext_html": "\n      <p>\n      My uncle has a 1 month old baby and our house faces mosquito problems in the rainy season. It's an old style tiled house so mosquito netting on doors and windows wont work since mosquitos will come through the roof. So I bought a mamaearth mosquito repellent patch for babies for the baby. Just wanna know whether it'll work enough to make the…",
      "downs": 0,
      "name": "t3_1x1g7s0",
      "upvote_ratio": null,
      "ups": 1,
      "total_awards_received": null,
      "score": 1,
      "created": 1791535713,
      "created_utc": 1791535713,
      "created_at_iso": "2026-10-09T08:48:33.000Z",
      "num_comments": 24,
      "url": "https://www.reddit.com/r/India_Parenting/comments/1x1g7s0/is_mamaearth_mosquito_repellent_patches_for/",
      "permalink": "/r/India_Parenting/comments/1x1g7s0/is_mamaearth_mosquito_repellent_patches_for/",
      "thumbnail": null,
      "thumbnail_blurred": false,
      "position": 0,
      "subreddit_subscribers": null,
      "is_video": false,
      "over_18": false,
      "spoiler": false,
      "relative_position": 0
    },
    {
      "id": "1x9s1dy",
      "post_id": "t3_1x9s1dy",
      "author": "a_user_75",
      "author_fullname": "t2_l4kbi38z",
      "subreddit": "PataHaiAajKyaHua",
      "title": "Mamaearth is SCAM",
      "selftext": "Pata hai aaj kya hua I bought sunscreen for the first time. Didn't knew about much options so picked this mamaearth sunscreen of Rs. 205. These f*kers have filled more air than chips packets. Feeling totally scammed. F*k this company.",
      "selftext_html": "\n      <p>\n      Pata hai aaj kya hua\n    </p><p>\n      I bought sunscreen for the first time. Didn't knew about much options so picked this mamaearth sunscreen of Rs. 205.\n    </p><p>\n      These f*kers have filled more air than chips packets.\n    </p><p>\n      Feeling totally scammed. F*k this company.\n    </p>\n    ",
      "downs": 0,
      "name": "t3_1x9s1dy",
      "upvote_ratio": null,
      "ups": 15,
      "total_awards_received": null,
      "score": 15,
      "created": 1792401241,
      "created_utc": 1792401241,
      "created_at_iso": "2026-10-19T09:14:01.000Z",
      "num_comments": 52,
      "url": "https://www.reddit.com/r/PataHaiAajKyaHua/comments/1x9s1dy/mamaearth_is_scam/",
      "permalink": "/r/PataHaiAajKyaHua/comments/1x9s1dy/mamaearth_is_scam/",
      "thumbnail": null,
      "thumbnail_blurred": false,
      "position": 1,
      "subreddit_subscribers": null,
      "is_video": false,
      "over_18": false,
      "spoiler": false,
      "relative_position": 1
    },
    "… 5 more item(s) truncated"
  ],
  "after": "eyJjYW5kaWRhdGVzX3JldHVybmVkIjoie1wic2VjdGlvbl8xX3BpcGVsaW5lXzBfZ2xvYmFsX21vZGlmaWVyc1wiOlwiMVwiLFwic2VjdGlvbl8xX3BpcGVsaW5lXzFfbG9jYWxfbW9kaWZpZXJzXCI6XCIyXCIsXCJzZWN0aW9uXzJfcGlwZWxpbmVfOF9keW5hbWljXzBfcG9zdF9zZWFyY2hcIjpcIjdcIixcInNlY3Rpb25fM19waXBlbGluZV8wX2R5bmFtaWNfMF9zdWJyZWRkaXRfc2VhcmNoXCI6XCI1XCIsXCJzZWN0aW9uXzNfcGlwZWxpbmVfMF9keW5hbWljXzFfYXV0aG9y…"
}
```

## Notes

- sort relevance for posts about the query; new returns the newest posts and can drift off topic.
- timeframe month or week keeps it current. No matches is free.
- Usually five to seven seconds.

## Siblings

- [`get_reddit`](https://parel.si/docs/tools/get_reddit.md) for one community's feed.
- [`search_news`](https://parel.si/docs/tools/search_news.md) for the press on the same topic.
