Contents

API reference / Reddit

List the subreddits worth being in

GET /api/v1/projects/{project}/reddit/subreddits

list_reddit_subreddits Read MCP tool

Ranked by fit: the threads found there, how often the brand and its competitors already come up in the project's own mentions, size, and what the rules say about promotion (policy: open, disclose, restricted, closed or unknown).

Any API key or OAuth token, or a signed-in member.

Parameters

NameTypeDescription
project required
path
string The project's id.
status
query
string Only subreddits with this status.
One of: candidate targeted ignored

Example

curl "https://sniffington.com/api/v1/projects/{project}/reddit/subreddits" \
  -H "Authorization: Bearer $SCOUT_API_KEY"