Reddit · Posts and media

Reddit Subreddit Posts Scraper API

The Reddit Subreddit Posts endpoint is one API call: send a subreddit name with your HProxy key and get back a clean, structured JSON object. Pull the posts in any subreddit, page by page, with title, body, author, score, comment count and timestamp. 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.

Get your API key Reddit API reference

0.15¢ per call
$1.49 per 1,000
Takes a subreddit name
Errors and timeouts are not charged

On Reddit

Profiles1Posts and media1Comments1 Search and trends2

Posts and media

The call

One GET, and the subreddit posts 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-posts?subreddit=dataisbeautiful" \
  -H "X-API-Key: hpx_your_key_here"

Response200 OK · JSON

{
  "posts": [
    { "id": "88120...", "text": "we just shipped something big",
      "author": { "username": "@handle" },
      "media": [ { "type": "photo", "url": "https://.../img.jpg" } ],
      "stats": { "reactions": 4120, "comments": 214, "shares": 88 },
      "createdAt": "2026-07-28T11:04:00Z" }
  ],
  "cursor": "eyJwYWdlIjoyfQ"
}

What comes back

The Reddit subreddit posts object.

posts[]: Each post with text, media and permalink.
author: Poster handle, ID and display name.
stats: Reactions, comments and shares per post.
createdAt: Publish timestamp, so you can sort and dedupe.

What it takes

Parameters.

subredditstringRequireddataisbeautiful

Subreddit name, without the r/ prefix.

timeframestringall

Filter by date, as YYYY-MM-DD. Allowed values: `all`, `day`, `week`, `month`, `year`.

sortstringbest

Ordering to apply to the results. Allowed values: `best`, `hot`, `new`, `top`, `rising`.

afterstringvalue

The after parameter.

trimbooleantrue

Return a slimmed-down payload (drops verbose fields).

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 posts, in three steps.

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

Create a free account Every Reddit endpoint

1
Create a free account
Sign up and top up any amount. The balance pays for every HProxy product.
2
Grab your API key
One key from the dashboard authenticates every scraper.
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 posts endpoint earns its keep.

Track everything an account publishes, automatically.
Feed a content archive or compliance record.
Benchmark posting cadence and engagement against rivals.

Reddit subreddit posts questions

Answered before you ask.

The reference

Send one authenticated HTTPS request to the Reddit Subreddit Posts endpoint with a subreddit name and your HProxy API key. Pull the posts in any subreddit, page by page, with title, body, author, score, comment count and timestamp. 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 posts 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.

Docs and AI

Connect your scraper to an AI, any time.

The whole Scraper API is published as markdown, so an assistant reads every endpoint, every parameter and a real response without a key and writes your integration. And because a scrape is one GET that answers in JSON, an agent can run the scraper itself, on its own schedule, with your key.

Read the scraper docs Set up your assistant

Claude, ChatGPT, Cursor, Gemini, Copilot, Windsurf, Perplexity, Ollama and any assistant that speaks MCP.

The API as markdown

Paste /llms/scraper-api.txt into Claude, ChatGPT, Cursor or Copilot: every endpoint and the whole catalog, in one file. No key and no account to read it.

Open the markdown

An agent can call it

One GET with your key returns structured JSON, so an agent scrapes on its own schedule. No browser to drive, no parser to keep alive between runs.

See the endpoints

MCP server and CLI

Built by us for the free tools and hosted at mcp.hproxy.com: the proxy list, the checker and the IP lookup as tools in Claude, ChatGPT, Cursor or any assistant that speaks MCP. Nothing to install, no key.

Add it to your assistant