Reddit Subreddit API
Resolve a public community to structured metadata — name, description, rules, icons, subscriber and weekly activity counts — in the shared Social Fetch envelope.
GET /v1/reddit/subreddits1 credit per successful request.
About this endpoint
Directory builders and brand monitors often need the community card before they pull a feed: does r/SaaS resolve, what does the sidebar say, how large is it, and is the name casing correct. Scraping old.reddit HTML for that card breaks when Reddit changes markup. Running a full Reddit OAuth client for a one-field enrichment job is more session work than the lookup is worth.
`GET /v1/reddit/subreddits` takes a `subreddit` query param (exact Reddit casing; optional `r/` prefix) or a `url` pointing at the community page. Send `x-api-key` and read `data.lookupStatus` before you write a row. On `found`, `data.subreddit` carries name, subredditId, url, description, rules, icon and banner URLs, advertiserCategory, submitText, and createdAt when Reddit exposes them; `data.metrics` has subscribers, weeklyActiveUsers, and weeklyContributions. `not_found` returns null subreddit and metrics; HTTP 200 still means the request finished.
Pricing is on the credit badge for this operation; `meta.creditsCharged` is the billing source of truth. For the community feed, use `GET /v1/reddit/subreddits/{subreddit}/posts`. For keyword search inside a community, use `GET /v1/reddit/subreddits/search`. This route stops at the subreddit card.
Reddit Subreddit API FAQ
How do I fetch Reddit subreddit metadata via API?
Call GET /v1/reddit/subreddits with your Social Fetch API key (x-api-key) and a subreddit query param (or url). Read data.lookupStatus, then data.subreddit and data.metrics. Full parameters and examples are in the API docs.
How much does a Reddit subreddit lookup cost?
Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged — that field is the billing source of truth.
Is the subreddit name case-sensitive?
Yes. Pass Reddit's exact casing (AbsoluteUnits, not absoluteunits) unless you pass a full community URL via url. Wrong casing can resolve as not_found even when the community exists.
What does the subreddit response include?
On a found lookup, data.subreddit can include platform, name, subredditId, url, description, rules, iconUrl, bannerUrl, advertiserCategory, submitText, and createdAt. data.metrics can include subscribers, weeklyActiveUsers, and weeklyContributions when available. Exact nullability lives in the OpenAPI schema for this route.
Subreddit metadata vs subreddit posts vs subreddit search?
Use this route for the community card only. Use GET /v1/reddit/subreddits/{subreddit}/posts for that community's feed. Use GET /v1/reddit/subreddits/search to search posts inside a known subreddit. They are separate operations on the Reddit hub.
What if the subreddit does not exist?
Branch on data.lookupStatus. Unknown or mismatched names resolve as not_found with null subreddit and metrics. Keep meta.requestId if you need support on a failed lookup.
Do I need Reddit OAuth to look up a subreddit?
No. You authenticate to Social Fetch with an API key. The route reads public community metadata; it does not act on behalf of a logged-in Reddit user or open private subreddits.