URL: /code/integrations/reddit · Id: `page:/code/integrations/reddit`

# Reddit

> Your agents find the threads where buyers describe your problem, draft an answer that solves it, and post it as you under your standing approval.

Your agents find the threads where buyers describe your problem, draft an answer that solves it, and post it as you under your [standing approval](https://startupbuilder.dev/business/nouns/mandate).

```text title="Run it · Ask"
Find this month’s Reddit threads where property managers ask how to track rent, spend up to 5¢.
```

```ts title="Run it · SDK"
import { $ } from 'startup-builder'

const result = await $.try.Keyword.search({ keyword: 'track rent spreadsheet', venue: 'reddit', within: '30d', maxCost: 0.05 })
```

```json title="Run it · Response"
{
  "$type": "Keyword",
  "mode": "try",
  "stored": false,
  "keyword": "track rent spreadsheet",
  "venue": "reddit",
  "results": [
    {
      "position": 1,
      "kind": "post",
      "url": "https://www.reddit.com/r/Landlord/comments/1kq9",
      "title": "What do you use to track rent for 40 units?",
      "snippet": "Spreadsheet is falling apart, renewal notices keep slipping.",
      "author": {
        "handle": "u/pm_in_tacoma"
      },
      "publishedAt": "2026-10-21T15:52:58Z",
      "engagement": {
        "score": 36,
        "comments": 55
      }
    },
    {
      "position": 2,
      "kind": "post",
      "url": "https://www.reddit.com/r/PropertyManagement/comments/1kp2",
      "title": "Renewal notices: how far out do you send them?",
      "snippet": "Lost two good tenants because the notice went out late.",
      "author": {
        "handle": "u/fourplexfred"
      },
      "publishedAt": "2026-10-18T03:12:40Z",
      "engagement": {
        "score": 22,
        "comments": 31
      }
    }
  ],
  "cost": {
    "usd": 0.0019,
    "maxUsd": 0.05
  }
}
```

- **Connect:** Sign in once, 1 grant
- **Runs through:** [A browser agent](/code/integrations#three-ways)
- **First run:** Find this month’s threads on your problem, about 0.03¢
- **Sites:** [Reddit](/venues#reddit)

## Connect once
1. Call `Integration.connect` with `system: 'social'` and `venue: 'reddit'`; a browser window opens on reddit.com.
2. Sign in with your own Reddit account. The session is saved to your browser profile; the platform never holds your password.
3. Name the 3 to 5 subreddits where the problem comes up. The agent reads each one’s sidebar and pinned posts into your records before it drafts a word.

| Grant | What it unlocks | Scope |
| --- | --- | --- |
| Your saved session | Comments, posts and replies as you, typed into Reddit’s own screens | `browser session: reddit.com` |

| To | Do this |
| --- | --- |
| Pause | `Integration.pause` holds every run that needs your Reddit session; the session stays saved. |
| Reconnect | `Integration.reconnect` opens a browser window where you sign in to Reddit once more; the saved session replaces the old one. |
| Disconnect | `Integration.revoke` deletes the saved Reddit session; every Post and reply it made stays in your records. |

## What your agents do
| Ask | Verb | Runs through | Price |
| --- | --- | --- | --- |
| Post this answer under the thread, signed in as me. | [`Post.publish`](/code/apps/social/publish) | A browser agent | About 1.6¢ a step |
| Answer each reply to my comment, signed in as me. | [`Conversation.answer`](https://startupbuilder.dev/business/nouns/conversation/answer) | A browser agent | About 1.6¢ a step |

Calls on your own account are free.

Reading this site’s public data needs no account: [`Keyword.search`](/code/data/keywords/search), [`Monitor.create`](/code/data/monitors/create) are Data calls (the [three ways a call runs](/code/integrations#three-ways)).

## What it holds
| Noun | The account’s object | When | Which side leads |
| --- | --- | --- | --- |
| [Post](https://startupbuilder.dev/business/nouns/post) | `comment or post` | Your agent posts | The account |
| [Thread](https://startupbuilder.dev/business/nouns/thread) | `comment thread` | Someone replies to your answer | The account |
| [Prospect](https://startupbuilder.dev/business/nouns/prospect) | `redditor` | Someone who fits replies, with the thread as their Reason | Your records |

## Events and webhooks
| Direction | Event |
| --- | --- |
| Emits | `Post.published`, `Post.withdrawn`, `Message.created`, `Prospect.engaged` |

Any Event can wake a Workflow, and a Watch delivers it to your endpoint, signed ([Events and webhooks](/code/events)).

## Limits
| What | Limit | Call |
| --- | --- | --- |
| Before each post | The agent rereads the subreddit’s sidebar and pinned posts and drafts to fit them; a post the moderators remove returns `venue-rejected` with their reason | [`Post.publish`](/code/apps/social/publish) |
| A new account | Posts help-only answers for its first 2 to 4 weeks in a community; mentions of your product wait until it has history there | [`Post.publish`](/code/apps/social/publish) |
| Mentions | At most 1 answer in 4 names your product, and only in subreddits that welcome it | [`Post.publish`](/code/apps/social/publish) |
| Pace | 10 answers a week across your subreddits, each within 6 hours of the post | Every call |
| Removals | The agent checks each post signed out every week; a removed post becomes `Post.withdrawn` with the reason it can read | Every call |

## Start here
| Move | The rule |
| --- | --- |
| Structure | 3 to 5 subreddits where the problem posts cluster, one account with real history in each, and each one’s sidebar and pinned posts read before the first answer. |
| Budget | Your time and about 1.6¢ a browser step: 10 answers a week, each within 6 hours of the post, at most 1 in 4 naming your product. |
| Creative | Solve the problem in the answer itself, with the steps, a number and a source. Name your product only where it is the honest answer, and say it is yours. |
| Kill rule | Judge at 30 answers by visits per thread. If answers are removed, post help-only for 2 weeks; if your posts vanish when signed out, stop and fix the account first. |

| Benchmark | Source |
| --- | --- |
| About 10% of an account’s activity is its own product (the 90/10 norm); many subreddits expect less | Community norm, practitioner write-ups |
| 2 to 4 weeks of real history in a community before a mention | Practitioner advice |
| Reddit is 46.7% of the top-10 domains Perplexity cites | AI citation study |
| 10 answers a week bring 30 to 150 visits in month 1, and more as old threads rank | Our planning number |

## Field map
| Our field | Reddit’s field | Notes | Calls |
| --- | --- | --- | --- |
| `Post.title` | `title` | 300 characters; a comment has none | [`Post.publish`](/code/apps/social/publish) |
| `Post.body` | `body or comment text` | None. | [`Post.publish`](/code/apps/social/publish) |
| `Post.handle` | `subreddit or parent post` | None. | [`Post.publish`](/code/apps/social/publish) |

## What try does here
Returns the answer as Reddit will show it, fitted to the subreddit’s sidebar and pinned posts, with the steps the browser agent would take; no session opens and nothing posts.

## How long a connection lasts
A connection lasts as long as the site keeps your saved session signed in; the platform checks the session before every run.

The platform asks you to reconnect 7 days before it runs out; until you do, a call that needs it refuses with [`needs-reauth`](/code/refusals#needs-reauth).

## Formats
| Site | Format | Size | Limits |
| --- | --- | --- | --- |
| [Reddit](/venues#reddit) | Text or link post | None. | Title 300 characters, which cannot be edited after posting |
| [Reddit](/venues#reddit) | Comment | None. | Text under a post or a comment; it has no title |
| [Reddit](/venues#reddit) | Promoted post | None. | A post already on your account, promoted with the title it earned replies under |

## Plays and strategies
| Kind | Where |
| --- | --- |
| Plays | [Community answers](/plays/community-answers), [Engagement bridge](/plays/engagement-bridge), [Tools on request](/plays/request-desk), [Launch week](/plays/launch-week) |
| Strategies | [Launch and search](/strategy/launch-and-search), [Hands-on](/strategy/hands-on) |

## Used by
- **Agent tasks:** [Answer threads](/capabilities/publish-and-post/answer-threads) · [Launch day](/capabilities/earn-first-links/launch-day)

## Reference

| Call | Path | Price |
| --- | --- | --- |
| [`Post.publish`](/code/apps/social/publish) | `POST /posts/publish` | About 1.6¢ a step |
| [`Conversation.answer`](https://startupbuilder.dev/business/nouns/conversation/answer) | `POST /conversations/answer` | About 1.6¢ a step |