---
title: "Subreddit About"
method: GET
path: "/api/reddit/sub/{name}/about"
tags: ["Listings & Search"]
---

# Subreddit About

`GET /api/reddit/sub/{name}/about`

## Request

- Base URL: `https://api.redditapis.com`
- URL: `https://api.redditapis.com/api/reddit/sub/{name}/about`
- Auth: HTTP bearer

Fetch a subreddit's public metadata: title, public description, subscriber count, active-user count, creation date, type, and NSFW flag. Returns a single object, not a list. The query form GET /api/reddit/subreddit?name= returns the same thing at the same price. Cost: $0.0015 per call.

## Path parameters

- `name` string, required

## Response `200`

Successful response.

- object
  - `name` string
  - `id` string
  - `fullname` string, nullable
  - `title` string, nullable
  - `display_name_prefixed` string, nullable
  - `public_description` string, nullable
  - `description` string, nullable
  - `subscribers` integer, nullable
  - `active_user_count` integer, nullable
  - `created_utc` number, nullable
  - `created` string, nullable
  - `over_18` boolean, nullable
  - `subreddit_type` string, nullable
  - `url` string, nullable
  - `lang` string, nullable
  - `icon_img` string, nullable
  - `banner_img` string, nullable

## Other responses

- `400`: Bad request — missing or invalid parameters.
- `401`: Missing Bearer token.
- `402`: Your account balance does not cover this call, so nothing was charged and the request was not served. The response body is {"error":"Insufficient credits","top_up_url":"https://www.redditapis.com/dashboard/buy-credits","message":"..."}; error keeps that exact wording. This is a billing state, not a bad request: the same call succeeds once the balance is topped up, and retrying without topping up returns 402 again, which is why it carries Retry-After: 3600. Top up at the top_up_url, then call again at once; the header does not apply after a top-up. Read the remaining balance any time from GET /account/me, which is free and never returns this error. Distinct from the 402 on the monitoring endpoints, which is about plan entitlements rather than credits.
- `403`: Invalid Bearer token.
- `429`: Rate limit exceeded.
- `500`: Unexpected server error.

---

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