---
title: "Reddit Subreddit Details"
method: GET
path: "/v1/reddit/subreddit"
tags: ["Reddit"]
---

# Reddit Subreddit Details

`GET /v1/reddit/subreddit`

## Request

- Base URL: `https://apidirect.io`
- URL: `https://apidirect.io/v1/reddit/subreddit`
- Auth: API key in header `X-API-Key`

Get a subreddit's details by name or URL. Returns member count, weekly active users, weekly contributions, title, description, full sidebar, creation date, community type, language, icon and banner, NSFW and quarantine flags, and a status saying whether it is active, private, banned or quarantined.

**Price:** $0.003 per request. **Free tier:** 50 requests/month.

## Query parameters

- `subreddit` string
- `url` string

## Response `200`

Successful response

- RedditSubredditDetailsResponse: Inferred from a live response. Any field can be null or absent, and new fields may be added at any time.
  - `subreddit` object, nullable
    - `name` string, nullable
    - `subreddit_id` string, nullable
    - `title` string, nullable
    - `description` string, nullable
    - `sidebar` string, nullable
    - `url` string, nullable
    - `subscribers` number, nullable
    - `weekly_active_users` number, nullable
    - `weekly_contributions` number, nullable
    - `created_at` string, nullable
    - `type` string, nullable
    - `status` string, nullable
    - `nsfw` boolean, nullable
    - `quarantined` boolean, nullable
    - `icon` string, nullable
    - `banner` string, nullable
    - `language` string, nullable

## Other responses

- `400`: Bad request: missing or invalid parameters
- `401`: Unauthorized: invalid or missing API key
- `402`: Free tier used up for this endpoint and no payment method on file (`payment_required`).
- `403`: Account blocked after a failed payment (`account_blocked`).
- `404`: Subreddit not found
- `429`: Rate limit exceeded or too many concurrent requests
- `500`: Internal server error
- `502`: Temporary failure retrieving Reddit data. Please retry shortly.
- `503`: Service temporarily unavailable. Please retry shortly.
- `504`: The request timed out

---

[API](https://skmtc.dev/apidirect/apis/api-direct.md) · [All operations](https://skmtc.dev/apidirect/apis/api-direct/llms.txt) · [OpenAPI document](https://skmtc.dev/apidirect/apis/api-direct/revisions/fa8c68d70bd0?raw)