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.

API base https://kieapi.com

curl -X POST "https://kieapi.com/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 "https://kieapi.com/v1/reddit/monitors/rdmon_01j/check" \
  -H "Authorization: Bearer $SPIDER_API_KEY"

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

Authentication

Use a bearer token.

Team administrators manage API keys in Team Settings. Each key keeps its Team and billing scope when its creator leaves or switches Teams. Keys cannot manage members, billing or other keys.

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.