Reddit is one of the worst sites to screenshot programmatically. A standard headless Chromium capture gives you a full-screen "Get the App" popup instead of actual content. Add bot detection, NSFW age gates, lazy-loaded images in comment threads — and your Puppeteer script returns something completely useless.
I spent a good chunk of time working through these problems while building ScreenshotRun's renderer. This post covers what breaks, why it breaks, what CSS you need to inject — and how to get clean Reddit screenshots with a single API call.
The popup that blocks everything
As of late 2026, Reddit shows an unclosable full-screen overlay on desktop browsers telling you to download their app. No dismiss button. The page behind it is frozen. Scroll is locked, content isn't reachable. Browser extensions exist specifically to kill this popup (the "Reddit Sign-In Popup Blocker" on the Chrome Web Store has tens of thousands of installs, which tells you how widespread the problem is).
For headless browsers, there's no extension to install. You need CSS injection to strip the overlay and restore scrolling. With the ScreenshotRun API, that looks like this:
curl "https://api.screenshotrun.com/v1/screenshots/capture?url=https://www.reddit.com/r/webdev&format=png&css=.XPromoPopup,shreddit-experience-tree,[class*='bottom-bar'],[id*='bottom-bar']{display:none!important}body,html{overflow:auto!important;position:static!important}&stealth=true&delay=3000" \
-H "Authorization: Bearer YOUR_API_KEY" \
--output reddit-screenshot.png
Two things are going on here. The css parameter injects styles that hide the popup overlay and restore page scrolling. The stealth parameter disguises the headless browser as a normal desktop Chrome session — without it, Reddit's bot detection kicks in before the page even loads.
Bot detection and stealth mode
Reddit fingerprints incoming browsers pretty aggressively. It checks navigator.webdriver, WebGL rendering, canvas fingerprints, installed plugins. A stock headless Chromium fails most of these checks and gets either a blank page or an error screen.
The stealth=true parameter handles all of this — it patches the browser fingerprint to match a real desktop Chrome session. We override navigator.webdriver, inject realistic plugin lists, fix WebGL vendor strings. Without stealth, success rate on Reddit sits around 15-20%. With it, we're above 95%.
But stealth alone doesn't guarantee anything. Reddit updates their detection periodically (they have good reason to — scraping is a sore subject for them after the 2023 API pricing controversy). Our renderer updates stealth patches to match, but it's a moving target. If you're building this yourself with Puppeteer, expect to maintain those patches.
old.reddit.com is basically dead
The common workaround used to be: forget the new UI, just screenshot old.reddit.com. The old interface was static HTML, loaded in under 2 seconds, made 33 HTTP requests versus 112 for the new version. Perfect for screenshots.
That's no longer an option. Reddit locked down old.reddit.com in mid-2026 — it requires login now, and new accounts can't access it at all. Only users who visited Old Reddit in the previous six months retained access. So unless you're maintaining a years-old Reddit session, old.reddit.com is off the table.
The new Reddit is a heavy SPA. It makes 100+ network requests on load, renders content with JavaScript, uses infinite scroll for comments, pulls in fonts asynchronously. So you need proper wait strategies. networkidle0 (which fires when network goes quiet for 500ms) isn't enough on its own — you need actual delays on top of it to let the React app finish hydrating.
Capturing full threads with comments
A Reddit post page doesn't have a fixed height. Comments load as you scroll. Images are lazy-loaded. "Continue this thread" links hide nested replies behind extra clicks. A regular viewport screenshot captures maybe 900px of a 15,000px thread.
For a full-thread capture:
curl "https://api.screenshotrun.com/v1/screenshots/capture?url=https://www.reddit.com/r/webdev/comments/abc123/my_post&format=png&full_page=true&css=.XPromoPopup,shreddit-experience-tree,[class*='bottom-bar'],[id*='bottom-bar']{display:none!important}body,html{overflow:auto!important;position:static!important}&stealth=true&delay=4000" \
-H "Authorization: Bearer YOUR_API_KEY" \
--output reddit-full-thread.png
The full_page=true parameter scrolls the entire page and stitches the result into one tall image. The API also forces lazy images to load during the scroll pass — it swaps data-src attributes to src and triggers Intersection Observer callbacks. Without that, you'd get placeholder boxes instead of actual images.
I bumped the delay to 4000ms here. Reddit threads with 200+ comments need that extra time for the JavaScript to finish rendering after the initial HTML payload arrives. Shorter delays give you partially loaded threads with collapsed comment sections.
NSFW and age-gated content
NSFW subreddits and individual flagged posts show an age verification screen. There's no way around this without a logged-in session. The age gate is server-side. Reddit checks your authentication state and returns a completely different page if you're not logged in.
If you need to capture NSFW content (compliance monitoring, content moderation workflows, legal evidence collection), you'll need to pass session cookies:
curl "https://api.screenshotrun.com/v1/screenshots/capture?url=https://www.reddit.com/r/some_nsfw_sub&format=png&stealth=true&delay=3000&cookies=reddit_session%3Dabc123%3B%20domain%3D.reddit.com&css=.XPromoPopup,shreddit-experience-tree,[class*='bottom-bar'],[id*='bottom-bar']{display:none!important}body,html{overflow:auto!important;position:static!important}" \
-H "Authorization: Bearer YOUR_API_KEY" \
--output reddit-nsfw.png
The cookies parameter injects your Reddit session into the browser before navigation. You'll need to extract the session cookie from a real browser — log into Reddit, open DevTools, grab the cookie value from Application > Cookies. These sessions expire, so plan to refresh them periodically if you're running automated captures.
Subreddit listings vs. individual posts
The URL structure matters more than you'd think. Subreddit listing pages (/r/webdev) render differently from individual posts (/r/webdev/comments/abc123/...). Listings are infinite-scroll feeds with card layouts. Individual posts have a fixed header section with the post content, then comments below.
For subreddit listings, viewport screenshots usually work better than full-page. You get the top posts without trying to capture an infinitely scrolling feed:
import requests
response = requests.get(
"https://api.screenshotrun.com/v1/screenshots/capture",
params={
"url": "https://www.reddit.com/r/webdev",
"format": "png",
"width": 1280,
"height": 900,
"stealth": "true",
"delay": 3000,
"css": ".XPromoPopup,shreddit-experience-tree,[class*='bottom-bar'],[id*='bottom-bar']{display:none!important}body,html{overflow:auto!important;position:static!important}",
"block_cookies": "true"
},
headers={"Authorization": "Bearer YOUR_API_KEY"}
)
with open("subreddit-listing.png", "wb") as f:
f.write(response.content)
I added block_cookies=true here to dismiss the cookie consent banner. Reddit serves GDPR banners to European IPs (or any IP that looks European based on geo headers), and those cover a solid 30% of the viewport if you don't deal with them.
Dark mode captures
Reddit has a dark mode that some users prefer for readability (and it looks better in presentations). Forcing dark mode in a screenshot is straightforward — the dark_mode parameter emulates prefers-color-scheme: dark at the browser level:
curl "https://api.screenshotrun.com/v1/screenshots/capture?url=https://www.reddit.com/r/programming&format=png&dark_mode=true&stealth=true&delay=3000&css=.XPromoPopup,shreddit-experience-tree,[class*='bottom-bar'],[id*='bottom-bar']{display:none!important}body,html{overflow:auto!important;position:static!important}" \
-H "Authorization: Bearer YOUR_API_KEY" \
--output reddit-dark.png
Reddit respects the media query and switches to their dark palette. No JS injection or theme toggle clicking required.
Mobile Reddit screenshots
Reddit's mobile layout is a completely different beast — different component hierarchy, different lazy loading behavior, different popup strategies. The mobile "Use App" banner is even more aggressive than the desktop popup.
To capture the mobile view:
curl "https://api.screenshotrun.com/v1/screenshots/capture?url=https://www.reddit.com/r/webdev&format=png&device=mobile&stealth=true&delay=3000&css=.XPromoPopup,shreddit-experience-tree,[class*='bottom-bar'],[id*='bottom-bar'],[class*='UseApp'],[class*='app-banner']{display:none!important}body,html{overflow:auto!important;position:static!important}" \
-H "Authorization: Bearer YOUR_API_KEY" \
--output reddit-mobile.png
The device=mobile parameter sets a mobile viewport (375×812, iPhone dimensions) with the right user agent string. I expanded the CSS injection to also target the mobile-specific app banners — the mobile UI uses different class names for its "Use App" prompts.
Putting it together: a Node.js batch script
If you need to capture multiple Reddit pages (monitoring a list of subreddits, archiving threads for legal purposes), a batch script does the job:
const API_KEY = process.env.SCREENSHOTRUN_API_KEY;
const BASE_URL = "https://api.screenshotrun.com/v1/screenshots/capture";
const fs = require("fs");
const REDDIT_CSS = [
".XPromoPopup",
"shreddit-experience-tree",
"[class*='bottom-bar']",
"[id*='bottom-bar']"
].join(",") + "{display:none!important}" +
"body,html{overflow:auto!important;position:static!important}";
const urls = [
"https://www.reddit.com/r/webdev",
"https://www.reddit.com/r/programming",
"https://www.reddit.com/r/node",
];
async function captureReddit(url) {
const params = new URLSearchParams({
url,
format: "png",
stealth: "true",
delay: "3000",
block_cookies: "true",
css: REDDIT_CSS,
});
const response = await fetch(`${BASE_URL}?${params}`, {
headers: { Authorization: `Bearer ${API_KEY}` },
});
if (!response.ok) {
console.error(`Failed ${url}: ${response.status}`);
return;
}
const slug = url.split("/r/")[1].replace(/\//g, "-");
fs.writeFileSync(`reddit-${slug}.png`, Buffer.from(await response.arrayBuffer()));
console.log(`Saved reddit-${slug}.png`);
}
(async () => {
for (const url of urls) {
await captureReddit(url);
// small gap between requests
await new Promise(r => setTimeout(r, 500));
}
})();
The CSS injection string is reusable across all Reddit URLs. I run requests sequentially with a 500ms gap — Reddit rate-limits parallel requests from the same origin. The ScreenshotRun API handles its own concurrency on the renderer side.
When screenshots still fail
Even with stealth mode and CSS injection, some Reddit pages are tricky. A few patterns I've run into:
Quarantined subreddits require a logged-in account that has explicitly opted in by clicking through the quarantine warning. No CSS trick bypasses this — you need session cookies from an account that already acknowledged the quarantine.
Rate-limited captures happen if you're hitting Reddit URLs faster than their servers like. The page loads a "you are doing that too much" message instead of content. Solution: space out your captures. Two to three seconds between requests is enough for most monitoring workflows.
Temporarily broken layouts show up when Reddit pushes UI changes (which happens often). The CSS selectors we use for popup removal might need updating. If your screenshots suddenly include an overlay that wasn't there last week, check Reddit's current DOM structure and update the css parameter.
FAQ#
Reddit displays a full-screen overlay on desktop browsers pushing users to download their mobile app. This popup has no dismiss button and locks page scrolling. To remove it, inject CSS that hides the overlay elements (.XPromoPopup, shreddit-experience-tree) and restores scrolling on body and html. The ScreenshotRun API css parameter handles this injection.
Yes, but you need a logged-in Reddit session. NSFW age verification is server-side, so Reddit returns a different page entirely for unauthenticated requests. Pass your Reddit session cookie via the cookies parameter in the API call. Extract the cookie from a real browser session using DevTools.
Reddit lazy-loads images using Intersection Observer. They only render when scrolled into the viewport. The ScreenshotRun API with full_page=true scrolls the entire page and triggers lazy image loading by swapping data-src to src and invoking observer callbacks. Without this, you get placeholder boxes instead of actual images.
Not reliably. Reddit restricted old.reddit.com in mid-2026. It now requires login, and new accounts cannot access it at all. Only users who visited Old Reddit in the previous six months retained access. The new Reddit SPA is now the default target for automated screenshots.
Use stealth mode. Reddit checks navigator.webdriver, WebGL rendering, canvas fingerprints, and installed browser plugins. The stealth=true parameter patches these fingerprints to match a real desktop Chrome session. Without stealth, success rate on Reddit is around 15-20 percent. With it, success rate exceeds 95 percent.