Reddit · Profiles

Reddit Subreddit Details Scraper API

The Reddit Subreddit Details endpoint is one API call: send either a subreddit or a URL with your HProxy key and get back a clean, structured JSON object. Pull a subreddit's metadata: description, subscriber and active-user counts, posted rules, topic and creation date. HProxy runs the proxies, sessions, anti-bot handling and parsing server-side, so there is no headless browser to babysit and no parser to keep fixing when Reddit changes its markup. You only ever touch the JSON.
  • 0.15¢ per call
  • $1.49 per 1,000
  • Takes either a subreddit or a URL
  • Errors and timeouts are not charged

The call

One GET, and the subreddit details comes back as JSON.

Your key goes in one header. 1 required parameter, and the answer is the object below it.

The full reference
curl "https://hproxy.com/api/v1/scrape/reddit/subreddit?subreddit=dataisbeautiful" \
  -H "X-API-Key: hpx_your_key_here"
Response200 OK · JSON
{
  "name": "Community name",
  "description": "What the community is for.",
  "memberCount": 412003,
  "rules": [ { "position": 1, "title": "Be civil" } ],
  "createdAt": "2013-06-11"
}

What comes back

The Reddit subreddit details object.

name / description
Community name, description and topic.
memberCount
Total members and active members where exposed.
rules[]
Posted community rules.
createdAt
When the community was created.

What it takes

Parameters.

Send any one of subreddit, url. subreddit or url required

subredditstringdataisbeautiful

Subreddit name, without the r/ prefix.

urlurlhttps://www.reddit.com/r/pics/comments/1abcdef/example/

Target URL (profile, post or video).

cache_max_agestring1d

Accept a cached result up to this old (1d, 3d, 7d, 14d or 30d) and pay nothing for it. Omit for a live scrape. Allowed values: `1d`, `3d`, `7d`, `14d`, `30d`.

How it works

Scraping Reddit subreddit details, in three steps.

You write one line. Proxies, anti-bot walls, rendering and parsing happen on our side.

  1. 1

    Create a free account

    Sign up and top up any amount. The balance pays for every HProxy product.
  2. 2

    Grab your API key

    One key from the dashboard authenticates every scraper.
  3. 3

    Call the endpoint

    Send the GET you need and read the JSON. That is the entire integration.

What people build with it

Where the Reddit subreddit details endpoint earns its keep.

  • Size a community before investing in it.
  • Monitor rule changes and moderation shifts.
  • Find the communities where your niche actually talks.

Reddit subreddit details questions

Answered before you ask.

The reference

Send one authenticated HTTPS request to the Reddit Subreddit Details endpoint with either a subreddit or a URL and your HProxy API key. Pull a subreddit's metadata: description, subscriber and active-user counts, posted rules, topic and creation date. No proxies, no headless browser and no parsing on your side. The response is ready-to-use JSON.

This endpoint is 0.15¢ per successful call, which is $1.49 per 1,000. It bills from your HProxy balance with no subscription and no monthly minimum. Errors are retried and never charged; a lookup whose target does not exist counts as a call.

The API only accesses publicly available Reddit data, the same pages anyone can open in a browser. You are responsible for using the data in line with applicable laws and Reddit's terms for your use case.

A structured JSON object with the full subreddit details data Reddit exposes publicly. See the fields listed above. The schema is consistent across calls, so you integrate once and rely on it.

No. Every call runs on HProxy's own residential network behind the scenes, so requests look like real users. The proxy layer is already included in the per-call price.

More on the Reddit Subreddit Details API

What the Reddit Subreddit Details endpoint returns

Pull a subreddit's metadata: description, subscriber and active-user counts, posted rules, topic and creation date. The JSON object carries name / description, memberCount, rules[] and createdAt. Nothing is summarised away on our side, so what you read in the response is what the Reddit subreddit details page itself holds.

What you send to the Reddit Subreddit Details API

The call takes either a subreddit or a URL, and any one of subreddit and url satisfies it. Optional: subreddit, url and cache_max_age. Your key travels in the X-API-Key header, the response is JSON, and the call is billed at 0.15¢, $1.49 per 1,000.

Profiles on other platforms

The same profiles data is available on 18 other platforms: Twitter / X Community, TikTok Profile, Facebook Profile, YouTube Channel, Instagram Profile, LinkedIn Profile, Threads Profile, Twitch Profile, Bluesky Profile, Spotify Artist, Truth Social Profile, Komi Page, Linkbio Page, Linkme Profile, Linktree Page, Pillar Page, Snapchat Profile and SoundCloud Artist. They share this endpoint's JSON shape, its per-call billing and your one API key, so moving from Reddit to another network is a change of URL rather than a second integration.

Is scraping Reddit subreddit details allowed?

The endpoint reads publicly available Reddit data, the same pages anyone can open in a browser without logging in. It does not touch private accounts or anything behind a password. How you then use the data is yours to keep lawful, under the rules that apply to you and to Reddit.

Ready when you are.

Your dashboard is ten seconds away. No sales call, no subscription, no minimum.