--- title: "Reddit" description: "Reddit posts and comments naming your keyword, in any subreddit." canonical: https://docs.mentio.dev/platforms/reddit markdown: https://docs.mentio.dev/platforms/reddit.mdx --- # Reddit Reddit posts and comments naming your keyword, in any subreddit. Mentio searches Reddit posts for your keyword as a phrase, newest first, across every subreddit, and searches Reddit's comments for it too, so a keyword said only in a comment, in a thread about something else, is found. | `platform` | `reddit` | | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- | | What is found | Posts (title and text), comments that name the keyword, and the comments under relevant posts when [comments](/guides/comments) are on | | Freshness | Posts about every hour, comments about every 3 hours | | Last 30 days on a new keyword | Yes, the newest 10 posts and the newest 10 comments | ## Track it [#track-it] Create a keyword limited to Reddit. Leave `platforms` out to search every platform. TypeScript: ```ts const response = await fetch('https://api.mentio.dev/v1/keywords', { method: 'POST', headers: { Authorization: `Bearer ${process.env.MENTIO_API_KEY}`, 'Content-Type': 'application/json', }, body: JSON.stringify({ "term": "Acme", "kind": "brand", "platforms": [ "reddit" ] }), }); const data = await response.json(); console.log(data); ``` Python: ```python import os import requests response = requests.post( "https://api.mentio.dev/v1/keywords", headers={"Authorization": f"Bearer {os.environ['MENTIO_API_KEY']}"}, json={ "term": "Acme", "kind": "brand", "platforms": [ "reddit" ] }, ) print(response.json()) ``` cURL: ```bash curl -X POST "https://api.mentio.dev/v1/keywords" \ -H "Authorization: Bearer $MENTIO_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "term": "Acme", "kind": "brand", "platforms": [ "reddit" ] }' ``` ## Read its mentions [#read-its-mentions] Filter the mentions list to Reddit. `subreddits` keeps the posts from those subreddits. TypeScript: ```ts const response = await fetch('https://api.mentio.dev/v1/mentions?platforms=reddit&subreddits=SaaS,startups', { method: 'GET', headers: { Authorization: `Bearer ${process.env.MENTIO_API_KEY}`, }, }); const data = await response.json(); console.log(data); ``` Python: ```python import os import requests response = requests.get( "https://api.mentio.dev/v1/mentions?platforms=reddit&subreddits=SaaS,startups", headers={"Authorization": f"Bearer {os.environ['MENTIO_API_KEY']}"}, ) print(response.json()) ``` cURL: ```bash curl -X GET "https://api.mentio.dev/v1/mentions?platforms=reddit&subreddits=SaaS,startups" \ -H "Authorization: Bearer $MENTIO_API_KEY" ``` Response (trimmed): ```json { "data": [ { "id": "mm_8f2k1x9q", "status": "open", "relevant": true, "keyword": { "id": "kw_123", "term": "Acme" }, "post": { "publishedAt": "2026-11-07T14:32:10.000Z", "platform": "reddit", "kind": "post", "url": "https://www.reddit.com/r/SaaS/comments/1gk2x9a/acme_vs_the_rest/", "title": "Acme vs the rest for a five-person team?", "text": "We are choosing between Acme and two others. Anyone using it in production?", "subreddit": "SaaS", "engagement": null }, "author": { "name": "quiet_founder", "handle": "quiet_founder", "url": "https://www.reddit.com/user/quiet_founder" }, "classification": { "relevance": 82, "sentiment": "positive", "intents": [ "buy_intent", "question" ], "note": "Someone asks about Acme by name." } } ], "nextCursor": "eyJ0IjoxNzMxMDAwMDAwfQ" } ``` ## What a mention carries [#what-a-mention-carries] * `post.text`: the title, the post's text, and the subreddit it was posted in. * `post.subreddit`: the subreddit, without the `r/` (`SaaS`). * `post.flair`: the post's flair, when its subreddit uses them and the search shows it. Posts found since 7 November 2026 carry none. * `post.engagement`: for a comment, `likes` is its score when it was found. Posts found since 7 November 2026 carry no score or comment count (`null`); older posts keep theirs. Counts are never refreshed. * `author`: the username and profile link. A deleted account has none. * A comment is a mention of `kind` `comment`, linked to the post it answers, which it replies to. ## Filter and group by subreddit [#filter-and-group-by-subreddit] * `subreddits=SaaS,startups` on [`GET /v1/mentions`](/api/mentions/search-mentions) keeps the Reddit posts from those subreddits (any case, with or without `r/`); `notSubreddits` leaves some out. Both work in [views](/guides/views), the exports and alert rules ("tell me when r/SaaS talks about us"). * `minLikes` keeps the comments with at least that score (and the older posts that carry one); a post found since 7 November 2026 has no score, so it never passes a minimum. * [`GET /v1/analytics/breakdown?by=subreddit`](/api/analytics/get-analytics-breakdown) ranks the subreddits your mentions come from. The rest is the same on every platform: relevance, sentiment and intent from the classifier, your triage, and the keyword it matched. See the [mention shape](/api). ## Mute an author [#mute-an-author] `reddit.com/user/name`, `u/name`, or a handle. A subreddit or a post link names no person and is refused. See [Mute authors](/alerts#mute-authors). ## Limits [#limits] * Posts are searched about every hour, so a post can arrive up to an hour after it is written. * Reddit's search also lists posts that hold a phrase's words apart. Only the posts your keyword's rule matches become mentions, and only those are billed. * Comments are searched about every three hours, so a comment can arrive up to three hours late. * The thread under a relevant mention is read when [comments](/guides/comments) are on for the keyword. A comment found both ways is one mention. * A link post matches on its title and subreddit, since it has no text. * Workspace filters can restrict matching to some subreddits, or leave some out.