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.

FieldTypeRequiredDescription
sortrelevance or new or top or comment_countnoPrefer 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"
trimbooleannoSet to true for a trimmed down version of the response. e.g. false
afterstringnoPagination token from the previous response (after) to get the next page
querystringyesSearch query. e.g. "ai"
filterposts or commentsnoSearch posts or comments. Default posts.. e.g. "posts"
timeframeall or day or week or month or yearnoPost 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 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: "search_reddit"
Over RESTPOST https://api.parel.si/v1/run with "tool": "search_reddit"
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":"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

This page as Markdown: /docs/tools/search_reddit.md. Something wrong or missing: hello@parel.si.