Contents

API reference / Reddit

List Reddit threads to join and posts to write

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

list_reddit_opportunities Read MCP tool

The work queue, best first. kind thread: an existing thread, with search reach and conversion scores (0 to 100), a recommended action (comment, help_only, monitor or skip) and the reasons. kind post: a thread you plan to start, with its brief and draft.

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

Parameters

NameTypeDescription
project required
path
string The project's id.
kind
query
string thread (join an existing one), post (start a new one in someone else's subreddit) or own (a post for the brand's own subreddit).
One of: thread post own
status
query
string Only items with this status.
One of: new drafted posted skipped
subreddit
query
string Only this subreddit.
min_priority
query
integer
0–100
limit
query
integer
1–100
Page size (default 25, max 100).

Example

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