Contents

API reference / Reddit

Plan the next posts for the brand's own subreddit

POST /api/v1/projects/{project}/reddit/own/ideas

plan_reddit_own_posts Write MCP tool

Plans posts from the project's saved keyword research (searches with monthly volume, and the Reddit threads Google ranks for them), the threads found on Reddit and questions in the project's mentions, keeping the mix: most help with the topic without naming the brand, the rest are about the brand. A topic gets one post: ideas never reword something already planned, posted or skipped, or already live in the subreddit (a planned idea found live is marked posted), so fewer than count come back when the research has nothing new. Each idea can then be drafted with draft_reddit_own_post. Nothing is posted.

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
count integer
2–12
How many posts to plan (default 6).

Returns

{ data: { ideas: Opportunity[], evidence: { searches, questions, ranking }, ai, notes } }

Example

curl -X POST "https://sniffington.com/api/v1/projects/{project}/reddit/own/ideas" \
  -H "Authorization: Bearer $SCOUT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"count":2}'