Skip to content

Check subreddit existence

Check if a subreddit exists and return basic info (title, subscriber count, NSFW status, post types allowed).

When accountId is provided, uses authenticated Reddit OAuth API with automatic token refresh (recommended). Falls back to Reddit's public JSON API, which may be unreliable from server IPs. Returns exists: false for private, banned, or nonexistent subreddits.

GET /v1/tools/validate/subreddit

Check if a subreddit exists and return basic info (title, subscriber count, NSFW status, post types allowed).

When accountId is provided, uses authenticated Reddit OAuth API with automatic token refresh (recommended). Falls back to Reddit's public JSON API, which may be unreliable from server IPs. Returns exists: false for private, banned, or nonexistent subreddits.

Parameters

  • name (query, string) required — Subreddit name (with or without "r/" prefix)

  • accountId (query, string) — Reddit social account ID for authenticated lookup (recommended for reliable results)

Responses

200 — Subreddit lookup result

one of:

    • exists (boolean)
  • subreddit (object)
    • exists (boolean)
  • error (string)