API 参考
创建监控任务
创建一个持续扫描 subreddit 或 search query 的监控任务。
POST
/api/open/v1/monitoring/jobs接口概览
201monitoring:write
创建一个持续扫描 subreddit 或 search query 的监控任务。
认证方式
请求头使用：
Authorization: Bearer <token>这个接口所需的 scopes：
monitoring:write请求体
mode
enum<string>监控模式。
subredditsearch
subreddit
stringsubreddit 模式的目标社区。
query
stringsearch 模式的搜索语句。
search_subreddits
string[]search 模式下限定的 subreddit，最多 10 个。
sort_type
enum<string>subreddit 模式排序。
hotnew
search_sort
enum<string>search 模式排序。
relevancehotnewtopcomments
search_time
enum<string>search 模式时间范围。
hourdayweekmonthyearall
limit
integer每轮扫描帖子数，10-40。
frequency_minutes
integer轮询频率，0-1440 分钟。
include_comments
boolean是否抓取评论。
comment_sort
enum<string>评论排序方式。
besttopnew
comment_limit
integer评论抓取数量，1-30。
language
enum<string>返回语言偏好。
zhen
响应
201 - application/json
id
string监控任务 ID。
object
string固定为 monitoring.job。
mode
stringsubreddit 或 search。
subreddit
stringsubreddit 模式下的目标 subreddit。
query
string | nullsearch 模式下的查询语句。
search_subreddits
string[]search 模式下限定的 subreddit 列表。
search_restrict_sr
boolean是否强制限定在 search_subreddits 内。
search_sort
string | nullsearch 模式排序方式。
search_time
string | nullsearch 模式时间范围。
sort_type
stringsubreddit 模式抓取排序方式。
limit
number单次拉取帖子数。
frequency_minutes
number监控频率（分钟）。
is_active
boolean任务是否激活。
include_comments
boolean是否抓取评论。
comment_sort
string评论排序方式。
comment_limit
number评论抓取上限。
comment_depth
number评论抓取深度。
auto_analyze
boolean是否自动分析命中帖子。
last_run_at
string | null最近一次执行时间。
next_run_at
string | null下一次预计执行时间。
created_at
string创建时间。
updated_at
string更新时间。
task_id
string首次调度生成的执行任务 ID。
queue_job_id
string | null底层队列任务 ID。
queued
boolean是否已成功入队。
常见错误
UNAUTHORIZED
error_code缺少或无效的 Bearer Token。
FORBIDDEN
error_code当前 Token 缺少所需 scope。
RATE_LIMITED
error_code当前 Token 触发限流。
INVALID_ARGUMENT
error_code请求参数不符合 schema 约束。
NOT_FOUND
error_code目标资源不存在，或不属于当前账户。
SUBSCRIPTION_REQUIRED
error_code当前账户套餐不支持创建监控任务，请升级 Base 或 Pro。
REDDIT_PROVIDER_MISCONFIGURED
error_code后端 Reddit 数据源未正确配置。
这个页面对你有帮助吗？