Reddit API

Monitor Reddit subreddits through public JSON listing checks.

Quick start

Create subreddit monitors, trigger manual checks, then read public new-post and updated-post events without exposing cookies, proxy URLs, or provider profile IDs.

curl -X POST "$SPIDER_API_BASE/v1/reddit/monitors" \
  -H "Authorization: Bearer $SPIDER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "subreddit": "python",
    "strategy": "json_fetch",
    "sort": "new",
    "check_interval_seconds": 900,
    "quiet_first_check": true
  }'

curl -X POST "$SPIDER_API_BASE/v1/reddit/monitors/rdmon_01j/check" \
  -H "Authorization: Bearer $SPIDER_API_KEY"

curl -X GET "$SPIDER_API_BASE/v1/reddit/monitors/rdmon_01j/posts?limit=100" \
  -H "Authorization: Bearer $SPIDER_API_KEY"

Authentication

Use a bearer token.

Create and manage product API keys in Product Console settings. The docs page itself is public.

Response shape

Monitor

The durable Reddit monitor, normalized subreddit target, settings, and json_fetch check state.

Identity boundary

Warmup and JSON fetch use the same logical identity, while public responses never include raw cookie values, proxy URLs, or provider profile identifiers.

Events

New post, updated post, and monitor error events for downstream workflows.

Posts

The latest observed Reddit post records with first_seen_at and last_seen_at timestamps.

Reference

Endpoint reference

OpenAPI-backed details for Reddit monitors, checks, events, posts, public errors, and pagination.

OpenAPI endpoint details

Interactive schemas, request bodies, response objects, and public error contracts load here.