API 参考
创建社区分析任务
创建一个新的社区分析异步任务。
POST
/api/open/v1/community-overview/jobs接口概览
201community_overview:write
创建一个新的社区分析异步任务。
认证方式
请求头使用：
Authorization: Bearer <token>这个接口所需的 scopes：
community_overview:write建议传递
Idempotency-Key，保证创建型请求安全重试。请求体
subreddit
string必填要分析的 subreddit，例如 saas。
include_about
boolean是否抓取 about 区块。
include_rules
boolean是否抓取 rules。
hot_limit
integerhot 帖子采样数，0-40。
new_limit
integernew 帖子采样数，0-40。
best_limit
integerbest 帖子采样数，0-40。
top_limit
integertop 帖子采样数，0-40。
rising_limit
integerrising 帖子采样数，0-40。
force_refresh
boolean是否跳过缓存强制重算。
language
enum<string>返回语言偏好。
zhen
响应
201 - application/json
id
string社区分析任务 ID。
object
string固定为 community_overview.job。
subreddit
string目标 subreddit。
status
string任务状态。
progress
number任务进度，范围 0-100。
stage_message
string | null当前分析阶段说明。
result_id
string | null完成后可用于定位结果对象。
created_at
string任务创建时间（ISO 8601）。
updated_at
string最近更新时间（ISO 8601）。
result_url
string结果可用时返回结果查询地址。
reused
boolean命中同一幂等键时返回 true。
常见错误
UNAUTHORIZED
error_code缺少或无效的 Bearer Token。
FORBIDDEN
error_code当前 Token 缺少所需 scope。
RATE_LIMITED
error_code当前 Token 触发限流。
INVALID_ARGUMENT
error_code请求参数不符合 schema 约束。
NOT_FOUND
error_code目标资源不存在，或不属于当前账户。
INSUFFICIENT_CREDITS
error_code账户积分不足，无法创建新任务。
说明
- 创建型接口建议始终带上 幂等-Key，避免重试时重复计费或重复建任务。
这个页面对你有帮助吗？