Skip to main content
API Reference

Create Monitoring Job

Create a monitoring job that continuously scans a subreddit or search query.

POST/api/open/v1/monitoring/jobs

Endpoint Overview

201monitoring:write

Create a monitoring job that continuously scans a subreddit or search query.

Authentication

Use this request header: Authorization: Bearer <token>
Required scopes for this endpoint:monitoring:write

Request Body

mode
enum<string>

Monitoring mode.

subredditsearch
subreddit
string

The target community in subreddit mode.

query
string

Search query in search mode.

search_subreddits
string[]

Restricted subreddits in search mode, up to 10.

sort_type
enum<string>

Sort order in subreddit mode.

hotnew
search_sort
enum<string>

Sort order in search mode.

relevancehotnewtopcomments
search_time
enum<string>

Time range in search mode.

hourdayweekmonthyearall
limit
integer

Posts scanned per run, 10-40.

frequency_minutes
integer

Polling frequency, 0-1440 minutes.

include_comments
boolean

Whether to fetch comments.

comment_sort
enum<string>

Comment sort order.

besttopnew
comment_limit
integer

Comment fetch count, 1-30.

language
enum<string>

Language preference to return.

zhen

Response

201 - application/json
id
string

Monitoring job ID.

object
string

Always monitoring.job.

mode
string

subreddit or search.

subreddit
string

Target subreddit in subreddit mode.

query
string | null

Query string in search mode.

search_subreddits
string[]

Restricted subreddit list in search mode.

search_restrict_sr
boolean

是否强制限定在 search_subreddits 内。

search_sort
string | null

Search sort mode.

search_time
string | null

Time range in search mode.

sort_type
string

Fetch sort order in subreddit mode.

limit
number

Number of posts fetched per run.

frequency_minutes
number

Monitoring frequency in minutes.

is_active
boolean

Whether the job is active.

include_comments
boolean

Whether to fetch comments.

comment_sort
string

Comment sort order.

comment_limit
number

Comment fetch limit.

comment_depth
number

Comment fetch depth.

auto_analyze
boolean

Whether to automatically analyze hit posts.

last_run_at
string | null

Most recent execution time.

next_run_at
string | null

Next scheduled execution time.

created_at
string

Creation time.

updated_at
string

Updated time.

task_id
string

The execution task ID created by the first schedule run.

queue_job_id
string | null

Underlying queue job ID.

queued
boolean

Whether the job was successfully queued.

Common Errors

UNAUTHORIZED
error_code

Missing or invalid Bearer token.

FORBIDDEN
error_code

The current token is missing the required scope.

RATE_LIMITED
error_code

The current token hit a rate limit.

INVALID_ARGUMENT
error_code

Request parameters do not satisfy the schema constraints.

NOT_FOUND
error_code

The target resource does not exist or does not belong to the current account.

SUBSCRIPTION_REQUIRED
error_code

The current account plan cannot create monitoring jobs. Upgrade to Base or Pro.

REDDIT_PROVIDER_MISCONFIGURED
error_code

The backend Reddit data source is not configured correctly.

Search API Docs

Full-text search across pages, sections, endpoints, and fields

Agent entry

If you are an agent, do not look for a separate manual first. RedditFind now keeps one shortest discovery index, one routing contract, and one API contract.

Use llms-index.txt to discover the stack quickly, agent-overview.json to route the job, and the OpenAPI spec when the workflow needs authenticated programmatic access.

Public demos still matter, but only for validating result shapes after the contracts are clear.

Why this stack is stronger now

  • Semantic detection layers Reddit discussions by demand, complaints, comparisons, and opportunities instead of relying on keywords alone.
  • The Reddit assistant connects discovery, analysis, monitoring, and next actions so agents do less manual orchestration.
  • With the Open API, agents can create jobs, read results, and plug RedditFind into their own workflows through a formal contract instead of guessing UI behavior.

Route by user objective

  • Community discovery Use when the user still does not know where demand, competitors, or relevant communities live. Open feature page
  • Subreddit analysis Use when target communities are already known and the user needs rules, tone, content patterns, and risks. Open feature page
  • Post monitoring Use when the user needs an ongoing queue of new opportunities, feedback signals, or high-intent threads. Open feature page
  • Reddit assistant Use when discovery, analysis, or monitoring context already exists and the user needs the next best action with lower execution risk. Open feature page

Core contracts and validation

Boundaries and non-goals

  • RedditFind does not auto-post to Reddit.
  • Human review is required before any public reply or post.
  • RedditFind does not support bulk direct-message automation.
  • It is not a generic web search engine or an autonomous posting bot that bypasses human oversight.
  • The Open API creates RedditFind jobs and reads results. It does not bypass human review for public Reddit engagement.