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.
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
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:
{
"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_redditfor one community's feed.search_newsfor the press on the same topic.
This page as Markdown: /docs/tools/search_reddit.md. Something wrong or missing: hello@parel.si.