Social Fetch
Reddit

Get Reddit subreddit

Get details for a Reddit community.

GET/v1/reddit/subreddits
1credit
x-api-key*stringheader

API key (`sfk_...`)

Parameters
2
subredditstringquery

Subreddit name, optional `r/` prefix, or Reddit subreddit URL. Must match Reddit's exact casing.

min 1 chars · max 256 chars

urlstringquery

Optional subreddit URL for the request.

min 1 chars · max 4096 chars

Response fields
22

Endpoint-specific response payload.

datalookupStatus
string

Whether the subreddit was found.

one of: found, not_found

Subreddit details when available.

datasubredditplatform
string

Social platform for this subreddit.

one of: reddit

datasubredditname
string

Public subreddit name.

datasubredditsubredditId
stringoptional

Stable subreddit identifier when available.

datasubredditurl
string

Canonical public subreddit URL.

min 1 chars

datasubredditdescription
stringnullable

Subreddit description text when available.

datasubredditrules
stringnullable

Subreddit rules text when available.

datasubredditiconUrl
stringnullable

Subreddit icon image URL when available.

datasubredditbannerUrl
stringnullable

Subreddit banner image URL when available.

datasubredditadvertiserCategory
stringnullableoptional

Advertiser category label when available.

datasubredditsubmitText
stringnullableoptional

Submission guidance text shown to members when available.

datasubredditcreatedAt
stringnullable

Subreddit creation timestamp when available.

Subreddit metrics when available.

datametricssubscribers
integernullable

Subscriber count when available.

≥ 0

datametricsweeklyActiveUsers
integernullable

Approximate weekly active users when available.

≥ 0

datametricsweeklyContributions
integernullable

Approximate weekly contributions when available.

≥ 0

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/reddit/subreddits?subreddit=AbsoluteUnits" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Lookup result. Check `data.lookupStatus` for `found` or `not_found`.

On this page

No Headings