Contents

API reference / Reddit

Find Reddit threads and subreddits worth being part of

POST /api/v1/projects/{project}/reddit/find

find_reddit_opportunities Write MCP tool

Searches Reddit for threads about the brand, its competitors and the topics people search when they need it ("best X", "X alternative", "X vs Y"), scores each by search reach and conversion, reads each subreddit's rules for what they say about promotion, and ranks the subreddits. Also uses the project's own Reddit mentions, so it still ranks subreddits when Reddit won't answer a server. Searches Reddit live and can take up to a minute.

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
topics array of string
up to 8 items
What people search when they need what you do, e.g. "crm for realtors". Saved on the project; omit to reuse the saved ones.

Returns

{ data: { searched, failed, reachable, hints, subreddits: Subreddit[], opportunities: Opportunity[] } }

Example

curl -X POST "https://sniffington.com/api/v1/projects/{project}/reddit/find" \
  -H "Authorization: Bearer $SCOUT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"topics":["…"]}'