Find Reddit threads and subreddits worth being part of
POST /api/v1/projects/{project}/reddit/find
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
| Name | Type | Description |
|---|---|---|
project requiredpath |
string | The project's id. |
Request body
JSON, sent with Content-Type: application/json.
| Name | Type | Description |
|---|---|---|
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":["…"]}'