# Reddit Subreddit Scraper (`akatra/reddit-subreddit-scraper`) Actor

Scrape Reddit subreddit posts without an API key or login: new, hot, top and rising listings for one or several communities. Title, text, score, upvote ratio, flair, links, media and dates. Only-new mode for monitoring.

- **URL**: https://apify.com/akatra/reddit-subreddit-scraper.md
- **Developed by:** [Akatra](https://apify.com/akatra) (community)
- **Categories:** Social media, News
- **Stats:** 1 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.05 / 1,000 posts

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Reddit Subreddit Scraper: posts from any subreddit

Scrape the posts of any public **subreddit** without an API key, an app registration or a Reddit account. Read the new, hot, top or rising listing of one or several communities and get clean structured data: title, text, score, upvote ratio, comment count, flair, author name, links, image and video URLs and exact timestamps.

Run it on a schedule with **Only new items** turned on and you get just the posts that appeared since your last run.

**Pay per result** · **No login, no API key** · **Public data only** · **LLM-ready JSON for AI agents (MCP)**

### 🛠️ What does Reddit Subreddit Scraper do?

- 📰 **Subreddit posts.** New, hot, top (with a time range) or rising, for one subreddit or several at once.
- 🔀 **Several subreddits as one feed.** Join subreddits with a plus sign (`python+learnpython`) to read them as one listing.
- 🆕 **Only new items mode.** Schedule it and get just what was not returned before.
- 🔒 **No user profile data.** Only the public username shown next to a post is saved. Profiles, karma and posting history are never collected.

This is the slim edition of [Reddit Scraper](https://apify.com/akatra/reddit-scraper): subreddit listings only, with a short input form. It does not search, open single posts or read comments.

- 🛡️ **Built to get through blocking.** Requests go out with a real browser fingerprint through rotating proxies, and a blocked request is retried from a fresh IP. A result that could not be completed is never charged.

#### What people use it for

- **Market and product research.** See what people ask, complain about and recommend in the subreddits of your market.
- **Trend and topic analysis.** Collect the top posts of a period and compare score, comment counts and flairs across communities.
- **Community monitoring.** Schedule the new listing of your subreddit or your competitors' with "Only new items" and send new posts to Slack, Google Sheets or your CRM.
- **Datasets for AI and NLP.** Build text datasets of posts with timestamps, scores and flairs.
- **Content and idea discovery.** Find what is rising in a niche before it is everywhere.

### 📊 What data can you extract?

Every result is one JSON object (one row in CSV or Excel), one post.

| Field | Meaning |
|---|---|
| `type`, `id`, `url` | `post`, Reddit's post id and the link to the post |
| `subreddit`, `title` | The community and the post title |
| `text` | The post body as Reddit markdown, `null` for link and image posts without text. For a crosspost it is the body of the original post |
| `createdAt` | When the post was created (UTC) |
| `score`, `upvoteRatio`, `numComments` | Net score, share of upvotes (0 to 1) and number of comments |
| `flair` | The post flair, if it has one |
| `isNsfw`, `isSpoiler`, `isStickied`, `isVideo` | Post flags |
| `linkUrl`, `domain` | The outside link of a link post as a full address and its domain (`self.<subreddit>` for text posts) |
| `thumbnailUrl`, `imageUrls`, `videoUrl` | Thumbnail, image links (single image or whole gallery) and the Reddit-hosted video link. For a crosspost they come from the original post |
| `isCrosspost`, `crosspostParentId`, `crosspostParentSubreddit` | Whether the post is a crosspost, and the id and subreddit of the original post |
| `author` | The public username of the poster (`[deleted]` for deleted accounts) |
| `searchQuery` | Always `null` here (it is filled by searches in Reddit Scraper and Reddit Search Scraper) |
| `scrapedAt` | When the record was collected (UTC) |

A field that does not exist for a record is `null`.

### 🚀 How to use Reddit Subreddit Scraper

1. Create a free [Apify](https://apify.com) account and open this Actor.
2. Add **subreddits**, one per line (`python`, `r/AskReddit` or a link).
3. Pick the **sort order**, and a **time range** if you chose Top.
4. Set **max posts per subreddit**.
5. Run it and download the results as JSON, CSV or Excel, or read them through the API.

### 📥 Input example (JSON)

```json
{
  "subreddits": ["python", "learnpython"],
  "sort": "top",
  "timeFilter": "week",
  "maxItemsPerQuery": 100,
  "onlyNew": false
}
```

### 📤 Sample output (JSON)

![Sample output table of Subreddit Scraper](https://api.apify.com/v2/key-value-stores/GkJnrNz6YWKHQYnZr/records/reddit-subreddit-scraper-output.png)

```json
{
  "type": "post",
  "id": "1wwbasv",
  "url": "https://www.reddit.com/r/Python/comments/1wwbasv/aurora_projet_experimental_fait_en_python/",
  "subreddit": "Python",
  "title": "Aurora, projet experimental fait en python",
  "text": "Je travaille actuellement sur **Aurora**, un projet open source expérimental qui permet de représenter les données binaires d’un fichier sous forme d’une image RGB.\n\nLe principe est simple :...",
  "createdAt": "2026-10-03T01:55:56+00:00",
  "score": 0,
  "upvoteRatio": 0.5,
  "numComments": 0,
  "flair": "News",
  "isNsfw": false,
  "isSpoiler": false,
  "isStickied": false,
  "isVideo": false,
  "linkUrl": null,
  "domain": "self.Python",
  "thumbnailUrl": null,
  "imageUrls": null,
  "videoUrl": null,
  "isCrosspost": false,
  "crosspostParentId": null,
  "crosspostParentSubreddit": null,
  "author": "Own-Location-8327",
  "searchQuery": null,
  "scrapedAt": "2026-10-03T02:44:31+00:00"
}
```

### 🤖 Use it with AI agents, MCP and the API

The output is clean JSON with stable field names, ready for LLM pipelines, RAG and agent tools without extra parsing.

- **AI agents and MCP (Claude, ChatGPT, Cursor and others).** Add the Apify MCP server with this Actor as a tool: `https://mcp.apify.com?tools=akatra/reddit-subreddit-scraper`. The agent can then run it and read the results by itself.
- **API.** Start a run and get the results in a single call:

```bash
curl -X POST "https://api.apify.com/v2/acts/akatra~reddit-subreddit-scraper/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"subreddits": ["python"], "sort": "new", "maxItemsPerQuery": 50}'
```

- **No-code tools and SDKs.** Works with Make, n8n, Zapier and LangChain through Apify's integrations, and with the Apify clients for Python and JavaScript. Schedule it and send the results to a webhook, Google Sheets or your own database.

### 💰 Pricing: pay per result

You pay per result: every post saved to the dataset is one result. See the price on the Pricing tab. Runs that return nothing cost only a tiny start fee. There is no subscription or rental fee. New to Apify? The free plan includes $5 of platform credit every month, enough for about 3,300 posts with this Actor, and no credit card is needed.

### 🚦 Run status and error messages

Every run ends with a plain status message, so automated workflows (API, Make, n8n, AI agents) can tell what happened without reading the log:

| Situation | What you get |
|---|---|
| Finished normally | `Saved N posts.` |
| Nothing matched | The run succeeds with `No results saved. Check the spelling of the subreddit, try another sort or time range, or turn off 'Only new items'.` You pay only the start fee. |
| Missing or invalid input | The run fails at once with `Invalid input: …` naming the field to fix, for example `Add at least one subreddit.` or `'searchQueries' is not supported in this Actor; use Reddit Scraper`. Nothing is scraped. |
| Private, quarantined or restricted subreddit | `r/name is private or restricted (reason).` The other subreddits are still read. |
| Subreddit does not exist or is banned | `r/name was not found (it may not exist or may be banned).` |
| Reddit blocked every request | The run succeeds with `Reddit blocked the requests for …, so nothing was saved. You were not charged. Please try again later.` |
| Some pages stayed blocked | `Results may be incomplete for: …` naming the subreddit. Run again to get the rest. |
| Your maximum charge is reached | Stops cleanly with `Stopped at your maximum charge limit.` Everything saved so far stays in the dataset. |

### ℹ️ Good to know

- **Max posts per subreddit** applies to each subreddit. Reddit ends a listing after about 1000 posts for New and Hot, and earlier for Top (about 500 in our tests), so higher numbers return what Reddit gives.
- **Time range** applies to the Top listing only. New, hot and rising ignore it.
- A post that two of your subreddits would return (for example `python` and `python+learnpython`) is returned once per run.
- **Only new items** remembers each subreddit and sort between runs. The first run returns everything up to your limit. Later runs return only posts that were not returned before and were created since 15 minutes before the previous run started; older posts that were never returned (for example because of your limit) stay out.
- Subreddit listings return 18+ posts as they are, with `isNsfw: true`. There is no option to filter them out.
- A crosspost keeps its own title, score, comment count, author and link, but its text, outside link, domain, images and video are filled in from the original post.
- This Actor does not read comments, searches or single posts. `numComments` tells you how many comments a post has. For the rest use the full [Reddit Scraper](https://apify.com/akatra/reddit-scraper).
- **How it reads Reddit:** the Actor does not use Reddit's official API. It reads the public pages Reddit shows to any visitor who is not logged in, with an anonymous visitor session, through residential IPs. Reddit's robots.txt disallows automated access, and Reddit can change or close this way of reading without notice. If that happens the run ends with a status message that Reddit blocked the requests, and you are not charged.
- If you set a maximum charge for a run, the scraper stops as soon as that limit is reached.
- **Privacy:** only content and the public username shown next to it are collected. User profiles, karma, account age and posting history are never read.

### 📝 Changelog

- **2026-10-03** First release: subreddit listings (new, hot, top, rising) and only-new mode.

### ⚖️ Legal and privacy

This scraper is an independent tool and is not affiliated with, endorsed by, or sponsored by Reddit. Reddit and its logo are trademarks of their owner and are used here only to describe which website the tool works with. Reddit's robots.txt disallows automated access and Reddit's terms of use restrict it; the Actor is not an official Reddit tool and does not use Reddit's API. Your use of the data is subject to Reddit's terms and to the laws that apply to you.

The Actor reads only pages that are public without logging in. Posts are written by Reddit users under pseudonyms and can contain personal information their authors chose to publish. How you store and use the data is your responsibility: follow the laws that apply to you, such as GDPR and CCPA.

### 🔗 More scrapers from Akatra

- [Indeed Jobs Scraper](https://apify.com/akatra/indeed-jobs-scraper): 💼 job ads from Indeed in 30 countries, with yearly salary and only-new mode.
- [Google News Scraper](https://apify.com/akatra/google-news-scraper): 📰 news by keyword or topic in 50 editions, with the real article URLs.
- [Google Trends Scraper](https://apify.com/akatra/google-trends-scraper): 📈 interest over time, by region, and rising related queries.
- [Google Ads Transparency Scraper](https://apify.com/akatra/google-ads-transparency-scraper): 🔎 every ad a company runs on Google, with regions and dates.
- [Airbnb Listings Scraper](https://apify.com/akatra/airbnb-listings-scraper): 🏠 Airbnb listings with prices, ratings and map coordinates.
- [YouTube Transcript Scraper](https://apify.com/akatra/youtube-transcript-scraper): 🎬 video transcripts as clean text and timestamped lines.

### 💬 Support

Found a bug or need a field that is missing? Open an issue on the Issues tab and we usually reply within a day.

### 🔗 Need more?

Searches, single post links, comment trees and the full set of options are in the complete [Reddit Scraper](https://apify.com/akatra/reddit-scraper).

# Actor input Schema

## `subreddits` (type: `array`):

Communities to read, one per line: a name (python), r/python or a link (https://www.reddit.com/r/python/). Join several with a plus sign (python+learnpython) to read them as one feed. Private, quarantined and banned communities cannot be read.

## `sort` (type: `string`):

Which listing of each subreddit to read.

## `timeFilter` (type: `string`):

Applies to the Top listing only: posts from this period. Ignored for New, Hot and Rising.

## `maxItemsPerQuery` (type: `integer`):

Stop after this many posts for each subreddit. Reddit ends a listing after about 1000 posts (earlier for Top).

## `onlyNew` (type: `boolean`):

Remember the posts of previous runs of the same subreddit and sort, and return only posts not seen before and created since 15 minutes before the previous run started. Made for scheduled runs.

## Actor input object example

```json
{
  "subreddits": [
    "python"
  ],
  "sort": "new",
  "timeFilter": "week",
  "maxItemsPerQuery": 100,
  "onlyNew": false
}
```

# Actor output Schema

## `results` (type: `string`):

All scraped posts, shown in the overview table.

## `resultsFull` (type: `string`):

All scraped posts with every field.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "subreddits": [
        "python"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("akatra/reddit-subreddit-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "subreddits": ["python"] }

# Run the Actor and wait for it to finish
run = client.actor("akatra/reddit-subreddit-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "subreddits": [
    "python"
  ]
}' |
apify call akatra/reddit-subreddit-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,akatra/reddit-subreddit-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/1vszlyDJvNU6XFy4o/builds/ng7IBIS7GFUK0WF9X/openapi.json