Contents

API reference / Reddit

Set the brand's own subreddit

PUT /api/v1/projects/{project}/reddit/own

set_reddit_own Write MCP tool

Saves which subreddit the brand runs (it doesn't have to exist yet) and the share of posts that help with the topic without naming the brand (helpful_share, 0.3 to 1, default 0.7). Reads the subreddit's size from Reddit when it exists.

A full-access key (ss_sk_…), or an editor or owner signed in.

Parameters

NameTypeDescription
project required
path
string The project's id.

Request body

JSON, sent with Content-Type: application/json.

NameTypeDescription
subreddit string The subreddit's name, with or without r/. Empty to clear.
helpful_share number
0.3–1
Share of posts that don't name the brand (default 0.7: seven in ten).

Example

curl -X PUT "https://sniffington.com/api/v1/projects/{project}/reddit/own" \
  -H "Authorization: Bearer $SCOUT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"subreddit":"…","helpful_share":1}'