v2

latestOpenAPI 3.1.02026-08-075421692.0 MB
Validate

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

Query parameters

namestring required
Example:programming

Subreddit name (with or without "r/" prefix)

accountIdstring

Reddit social account ID for authenticated lookup (recommended for reliable results)

Response

Subreddit lookup result

OR

Example response

{
  "subreddit": {
    "name": "programming",
    "title": "programming",
    "description": "Computer Programming",
    "subscribers": 6844284,
    "type": "public"
  }
}