Social Fetch
Reddit

Get Reddit subreddit

Get details for a Reddit community.

Operation

GET/v1/reddit/subreddits

Headers

x-api-keystringrequired(header)

API key (`sfk_...`)

Parameters

subredditstring(query)

Subreddit name, optional `r/` prefix, or Reddit subreddit URL. Must match Reddit's exact casing (for example `AskReddit`, not `askreddit`).

min 1 chars · max 256 chars

urlstring(query)

Optional subreddit URL for the request.

min 1 chars · max 4096 chars

Response fields

data
objectrequired

Endpoint-specific response payload.

datalookupStatus
stringrequired

Whether the subreddit was found or not found.

one of: found, not_found

datasubreddit
objectrequirednullable

Subreddit details when available.

datasubredditplatform
stringrequired

Social platform for this subreddit.

one of: reddit

datasubredditname
stringrequired

Public subreddit name.

datasubredditsubredditId
string

Stable subreddit identifier when available.

datasubredditurl
stringrequired

Canonical public subreddit URL.

min 1 chars

datasubredditdescription
stringrequirednullable

Subreddit description text when available.

datasubredditrules
stringrequirednullable

Subreddit rules text when available.

datasubredditiconUrl
stringrequirednullable

Subreddit icon image URL when available.

datasubredditbannerUrl
stringrequirednullable

Subreddit banner image URL when available.

datasubredditadvertiserCategory
stringnullable

Advertiser category label when available.

datasubredditsubmitText
stringnullable

Submission guidance text shown to members when available.

datasubredditcreatedAt
stringrequirednullable

Subreddit creation timestamp when available.

datametrics
objectrequirednullable

Subreddit metrics when available.

datametricssubscribers
integerrequirednullable

Subscriber count when available.

≥ 0

datametricsweeklyActiveUsers
integerrequirednullable

Approximate weekly active users when available.

≥ 0

datametricsweeklyContributions
integerrequirednullable

Approximate weekly contributions when available.

≥ 0

meta
objectrequired

Metadata describing the request and billing outcome.

metarequestId
stringrequired

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integerrequired

Credits charged for this request.

≥ 0

metaversion
stringrequired

Public API version that served the response.

one of: v1

Code example

Responses

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

Error codes

bad_requestinsufficient_creditsinternal_errorlookup_failedtemporarily_unavailableunauthorized

On this page