# Reddit Profile Scraper (`agentx/reddit-profile-scraper`) Actor

Reddit profile scraper that turns a username, u/ handle, or profile URL into a 26-field profile with up to 1,000 posts and 10,000 comments in one run. Covers karma, account age, status flags, moderated communities, and trophies. From $0.0225 per profile.

- **URL**: https://apify.com/agentx/reddit-profile-scraper.md
- **Developed by:** [AgentX](https://apify.com/agentx) (community)
- **Categories:** Social media, Lead generation, Agents
- **Stats:** 12 total users, 2 monthly users, 100.0% runs succeeded, 3 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $0.0225 / result

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?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

**Reddit Profile Scraper is a reddit profile scraper that turns one public username into a 33-field profile with karma, account state, moderated communities, trophies, stored media, and requested post and comment history.** It is built for research and enrichment workflows that already know which account to inspect.

[![Apify Users](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fapi.apify.com%2Fv2%2Facts%2Fagentx~reddit-profile-scraper\&query=%24.data.stats.totalUsers\&style=for-the-badge\&label=Apify%20Users\&color=ff9013)](https://apify.com/agentx/reddit-profile-scraper) [![Apify Runs](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fapi.apify.com%2Fv2%2Facts%2Fagentx~reddit-profile-scraper\&query=%24.data.stats.totalRuns\&style=for-the-badge\&label=Apify%20Runs\&color=ff9013)](https://apify.com/agentx/reddit-profile-scraper) [![price](https://img.shields.io/badge/%240.03000%20%2F%20profile-4285f4?style=for-the-badge)](https://apify.com/agentx/reddit-profile-scraper/pricing) [![capability](https://img.shields.io/badge/33%20profile%20fields-34a853?style=for-the-badge)](https://console.apify.com/actors/bb0YV0rZPcvyB4fX8/input) [![API + MCP ready](https://img.shields.io/badge/API%20%2B%20MCP%20ready-fbbc05?style=for-the-badge)](https://apify.com/agentx/reddit-profile-scraper/api)

- **Three explicit required inputs** accept a username, `u/` handle, or full profile URL and independently control post and comment depth.
- **33 top-level Dataset fields** cover identity, karma, account flags, profile media, trophies, moderated communities, activity, and provenance.
- **Nested activity keeps source context** including post polls, media facts, duplicate URLs, and a comment's external link when it differs from the Reddit thread.
- **One account produces one profile row** while optional posts and comments are charged only when they are included.

The smallest useful FREE-tier run sets both activity caps to `0`; one Actor Start plus one profile Result costs at most **$0.04000**.

### Why Choose Reddit Profile Scraper

**Known-account lookup.** Provide one public Reddit identity and receive one joinable row instead of manually copying profile facts from several screens.

**Activity depth under your control.** `max_posts` and `max_comments` are independent, accept `0`, and have no configured upper limit; asking above the available history returns everything Reddit serves.

**Source-state distinctions preserved.** Missing values are omitted, explicit `false` and zero remain meaningful, and a suspended account can still produce a reduced profile row.

**Rich nested context.** Posts can include flair, engagement, crosspost context, stored media, poll options, and duplicate URLs; comments can include parent-post context, external links, and inline images.

**Stable provenance.** Every row ends with `processor` and an ISO `processed_at` timestamp for attribution and snapshot comparisons.

### Quick Start Guide

#### Configure

Open the Actor input and enter `spez`, `u/spez`, or `https://www.reddit.com/user/spez/`. All three forms resolve to the same public account. Set each activity cap to the amount your workflow needs.

#### Run

Start with one post and one comment:

```json
{
  "username": "spez",
  "max_posts": 1,
  "max_comments": 1
}
```

#### Collect

Open the default Dataset after the run succeeds. Export JSON or JSONL when nested posts, comments, trophies, moderated communities, polls, or media arrays matter; use CSV or Excel for flatter profile analysis.

### Input Parameters

Reddit Profile Scraper has three required inputs in schema order, with no hidden filters or credential fields.

| Parameter | Type | Required | Description | Example |
| --- | --- | --- | --- | --- |
| `username` | string | Yes | Public account as a username, `u/` handle, or profile URL | `spez` |
| `max_posts` | integer, minimum 0 | Yes | Maximum submissions to request; `0` skips posts | `1` |
| `max_comments` | integer, minimum 0 | Yes | Maximum comments to request; `0` skips comments | `1` |

The caps are request maximums, not promises about source inventory. A quiet, new, deleted, or restricted account may expose less activity. Neither input has a configured maximum: an oversized request ends when Reddit's listing ends rather than failing solely because the requested number is large.

### Output Data Schema

One Dataset row represents one Reddit user profile; the public contract has 33 top-level fields.

| Group | Fields |
| --- | --- |
| Identity | `id`, `name`, `username`, `url`, `about`, `created_at` |
| Profile presentation | `avatar`, `avatar_size`, `banner`, `banner_size`, `profile_color`, `snoovatar` |
| Verification and karma | `verified`, `verified_email`, `post_karma`, `comment_karma`, `awardee_karma`, `awarder_karma`, `total_karma` |
| Audience and state | `follower_count`, `accept_followers`, `is_premium`, `is_employee`, `is_moderator`, `is_suspended`, `over_18`, `robots_hidden` |
| Collections | `trophies`, `moderated`, `posts`, `comments` |
| Provenance | `processor`, `processed_at` |

This abbreviated example truncates every nested collection; real rows may contain many more fields inside posts, comments, trophies, and communities:

```json
{
  "id": "1w72",
  "username": "spez",
  "url": "https://www.reddit.com/user/spez/",
  "post_karma": 184005,
  "comment_karma": 756202,
  "total_karma": 940207,
  "is_employee": true,
  "trophies": [{"name": "15-Year Club"}],
  "moderated": [{"name": "r/announcements", "subscribers": 302603085}],
  "posts": [{"id": "1u7hraf", "title": "21 years of Reddit", "score": 840}],
  "comments": [{"id": "os0o1vi", "score": 95, "is_root": false}],
  "processor": "https://apify.com/username/actor_name",
  "processed_at": "2026-08-12T10:44:55+00:00"
}
```

Unavailable source facts are omitted rather than invented. A suspended account may have `username`, `total_karma`, and `is_suspended` while ordinary presentation fields are absent.

### Integration Examples

Use `agentx/reddit-profile-scraper` as the Actor name form in API, SDK, Task, and Scheduler workflows.

#### Actor ID

```text
bb0YV0rZPcvyB4fX8
```

The stable name form is `agentx/reddit-profile-scraper`.

#### HTTP

```bash
curl -X POST "https://api.apify.com/v2/acts/agentx~reddit-profile-scraper/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"username":"spez","max_posts":1,"max_comments":1}'
```

#### Python

```python
from apify_client import ApifyClient

client = ApifyClient("<APIFY_TOKEN>")
run = client.actor("agentx/reddit-profile-scraper").call(
    run_input={"username": "spez", "max_posts": 1, "max_comments": 1}
)
items = list(client.dataset(run["defaultDatasetId"]).iterate_items())
```

#### JavaScript

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

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('agentx/reddit-profile-scraper').call({
  username: 'spez', max_posts: 1, max_comments: 1,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
```

#### Make.com and n8n

Use Actor ID `bb0YV0rZPcvyB4fX8`, paste the three-field JSON input, wait for completion, then read the default Dataset. Keep the API token in the integration's credential store.

#### MCP

Connect to Apify's hosted MCP server and call `agentx/reddit-profile-scraper` with the same scenario. See the [official Apify MCP guide](https://docs.apify.com/integrations/mcp) for current client setup.

### Pricing

At the FREE tier, Reddit Profile Scraper costs $0.03000 per profile Result plus $0.01000 per Actor Start; the smallest profile-only run totals **$0.04000**.

| Event | FREE | BRONZE | SILVER | GOLD | PLATINUM | DIAMOND |
| --- | ---: | ---: | ---: | ---: | ---: | ---: |
| Actor Start | $0.01000 | $0.01000 | $0.01000 | $0.01000 | $0.01000 | $0.01000 |
| Result | $0.03000 | $0.02700 | $0.02400 | $0.02250 | $0.02250 | $0.02250 |
| Post | $0.00500 | $0.00450 | $0.00400 | $0.00375 | $0.00375 | $0.00375 |
| Comment | $0.00100 | $0.00090 | $0.00080 | $0.00075 | $0.00075 | $0.00075 |

The Actor Start is charged when the run begins. The single Result covers the profile row; Post and Comment events cover activity items actually included. A FREE-tier run with one profile, one post, and one comment is at most **$0.04600**. Set a maximum total charge for exploratory runs and confirm current amounts on the [pricing page](https://apify.com/agentx/reddit-profile-scraper/pricing), because prices can change.

### Use Cases

- **Account enrichment** — join `created_at`, karma counters, account state, and follower data to a lawful list of known Reddit usernames.
- **Moderator research** — inspect `moderated`, community subscriber counts, trophies, and sampled activity before a human review.
- **Creator context** — compare public topics, communities, scores, media, and poll participation across known authors.
- **Recurring snapshots** — schedule the same input and use `processed_at` to compare profile and activity changes over time.
- **Content provenance** — follow `post_url`, `comment_url`, `external_url`, crosspost fields, and duplicate URLs back to source context.

### Alternatives

Manual browsing is appropriate for a one-off visual check when no export or repeatability is needed. It becomes inefficient when profiles must be joined, compared, scheduled, or retained with a collection timestamp.

Reddit's own developer offering is the right choice for authorized application features, write actions, or a first-party API integration. Reddit's [Data API guidance](https://support.reddithelp.com/hc/en-us/articles/16160319875092-Reddit-Data-API-Wiki) explains its access and usage requirements. This Actor is designed for read-only public profile snapshots and does not claim official API affiliation.

Community- or search-first Actors are better when the username is not yet known. Choose something else for private data, deleted content recovery, identity verification, bulk usernames in one input, or automated decisions about people.

### Limits and Troubleshooting

- **Fewer items than requested →** the caps are maximums and Reddit controls available listing depth → retry with `1` to distinguish source availability from volume.
- **User not found →** the account may be misspelled or deleted → verify the public profile URL, then retry the exact username.
- **Reduced row with `is_suspended` →** Reddit exposes a smaller payload for suspended accounts → treat absent fields as unavailable, not as `false`.
- **Zero shipped activity after collection →** a maximum total charge can prevent optional billed items from being included → inspect event counts before raising the charge limit.
- **Nested arrays look flattened →** tabular exports cannot preserve every nested object cleanly → use JSON or JSONL.
- **Temporary retrieval failure →** public source availability varies → retry later with the smallest input before increasing the workload.

For a reproducible defect, open an [Actor issue](https://apify.com/agentx/reddit-profile-scraper/issues) with the public run ID, exact input, and expected outcome. Never include an API token or unrelated personal data.

### Trust and Reliability

The Actor runs on Apify and writes to the default Dataset through the documented pay-per-event contract. Its public schema lists 33 top-level fields, and every row carries `processor` and `processed_at` provenance. Source facts are normalized without guessing missing values; relationship flags tied to a requesting session are not presented as facts about the person.

### Legal and Compliance

**Public scope.** Use the Actor only for public account information and activity that Reddit exposes at run time.

**Privacy.** Collect the minimum data needed, define a lawful purpose, apply retention controls, and avoid high-impact automated decisions about individuals.

**Platform terms.** Review Reddit's current terms and [developer access guidance](https://support.reddithelp.com/hc/en-us/articles/14945211791892-Developer-Platform-Accessing-Reddit-Data) for your use case. You are responsible for how collected data is used.

### Frequently Asked Questions

#### Can I run a bulk reddit user lookup?

Yes, by launching one run per username through the API, Tasks, or an orchestrator. Each run intentionally accepts one identity and produces one profile row.

#### Does it support reddit karma and history export?

Yes. The row contains separate post, comment, awardee, awarder, and total karma fields plus requested posts and comments, exportable from the Dataset.

#### Is there a free Reddit profile API?

The smallest run still has pay-per-event charges. Use both activity caps at `0` and a maximum total charge to evaluate the 33-field profile contract at the lowest workload.

#### Can I schedule runs to monitor Reddit profiles over time?

Yes. Create an Apify Schedule with a fixed username and compare snapshots by `processed_at`; interpret changes as observations, not explanations.

#### Can I pass a full profile URL?

Yes. A username, `u/` handle, and full profile URL normalize to the same account identifier.

#### Are posts and comments complete histories?

No. The arrays are bounded by the requested caps and by what Reddit exposes through its listings at run time.

#### Do I need Reddit credentials?

No credential field exists in the three-input schema. You need an Apify account or token to start the Actor.

#### Is karma an exact count of upvotes?

No. Reddit describes karma as an approximate reflection of votes. Treat it as a source-reported signal rather than audited engagement.

### Related AgentX Actors

AgentX publishes 77 Actors — the three closest Reddit workflows first, then the full catalog by category.

Closest to this Actor:

- [Reddit Viral Scraper](https://apify.com/agentx/reddit-viral-scraper) — discovers posts from keywords before known authors are profiled here.
- [Subreddit Posts Scraper](https://apify.com/agentx/subreddit-posts-scraper) — collects community-level posts instead of one user's activity.
- [SubReddit Info Scraper](https://apify.com/agentx/subreddit-info-scraper) — adds community identity, audience, and settings to author research.

#### Business and Market Intelligence

- **[Google Keyword Trends](https://apify.com/agentx/google-keyword-trends)** — Google Trends keyword interest, compared five at a time
- **[Google Trends Scraper](https://apify.com/agentx/google-trends-scraper)** — Google Trends trending searches
- **[Google Maps Store Scraper](https://apify.com/agentx/google-maps-store-scraper)** — Google Maps business listings
- **[LinkedIn Company Lookup](https://apify.com/agentx/linkedin-company-lookup)** — LinkedIn company records
- **[LinkedIn Profile Lookup](https://apify.com/agentx/linkedin-profile-lookup)** — LinkedIn profile records
- **[Weather Forecast API](https://apify.com/agentx/weather-forecast-api)** — forecast and historical weather data

#### Jobs and Hiring

- **[All Jobs Scraper](https://apify.com/agentx/all-jobs-scraper)** — multi-platform job listings
- **[Bayt Jobs Scraper](https://apify.com/agentx/bayt-jobs-scraper)** — Bayt job listings
- **[Glassdoor Jobs Scraper](https://apify.com/agentx/glassdoor-jobs-scraper)** — Glassdoor job listings
- **[Indeed Jobs Scraper](https://apify.com/agentx/indeed-jobs-scraper)** — Indeed job listings
- **[JobStreet Company Profile](https://apify.com/agentx/jobstreet-company-profile)** — JobStreet employer records
- **[Jooble Jobs Scraper](https://apify.com/agentx/jooble-jobs-scraper)** — Jooble job listings
- **[LinkedIn Jobs Scraper](https://apify.com/agentx/linkedin-jobs-scraper)** — LinkedIn job listings
- **[Naukri Jobs Scraper](https://apify.com/agentx/naukri-jobs-scraper)** — Naukri job listings
- **[Talent Jobs Scraper](https://apify.com/agentx/talent-jobs-scraper)** — Talent.com job listings
- **[ZipRecruiter Jobs Scraper](https://apify.com/agentx/ziprecruiter-jobs-scraper)** — ZipRecruiter job listings

#### Social Media

- **[Instagram Creator Scraper](https://apify.com/agentx/instagram-creator-scraper)** — Instagram creator profiles
- **[Instagram Reels Scraper](https://apify.com/agentx/instagram-reels-scraper)** — Instagram Reels metadata
- **[Instagram Trending Scraper](https://apify.com/agentx/instagram-trending-scraper)** — Instagram trending content
- **[Medium Scraper](https://apify.com/agentx/medium-scraper)** — Medium articles
- **[Medium Profile Scraper](https://apify.com/agentx/medium-profile-scraper)** — Medium author profiles
- **[Reddit Viral Scraper](https://apify.com/agentx/reddit-viral-scraper)** — Reddit viral posts
- **[SubReddit Info Scraper](https://apify.com/agentx/subreddit-info-scraper)** — subreddit metadata
- **[Subreddit Members Scraper](https://apify.com/agentx/subreddit-members-scraper)** — subreddit member lists
- **[Subreddit Posts Scraper](https://apify.com/agentx/subreddit-posts-scraper)** — subreddit post feeds
- **[Telegram Chat Scraper](https://apify.com/agentx/telegram-chat-scraper)** — Telegram chat messages
- **[Telegram Info Scraper](https://apify.com/agentx/telegram-info-scraper)** — Telegram channel metadata
- **[Telegram Member Adder](https://apify.com/agentx/telegram-member-adder)** — Telegram group membership management
- **[Telegram Member Scraper](https://apify.com/agentx/telegram-member-scraper)** — Telegram group members
- **[Telegram Private Group Scraper](https://apify.com/agentx/telegram-private-group-scraper)** — private Telegram group data
- **[TikTok Creator API](https://apify.com/agentx/tiktok-creator-api)** — TikTok creator profiles
- **[TikTok User Lookup](https://apify.com/agentx/tiktok-user-lookup)** — TikTok account records
- **[X Twitter Community API](https://apify.com/agentx/x-twitter-community-api)** — X community data
- **[X Twitter Profile Lookup](https://apify.com/agentx/x-twitter-profile-lookup)** — X profile records
- **[YouTube Creator Email Scraper](https://apify.com/agentx/youtube-creator-email-scraper)** — YouTube creator contact data

#### Video, Transcripts and Downloads

- **[All Video Scraper](https://apify.com/agentx/all-video-scraper)** — multi-platform video metadata
- **[Video Transcript](https://apify.com/agentx/video-transcript)** — multi-platform transcripts
- **[Video Captions Downloader](https://apify.com/agentx/video-captions-downloader)** — caption files
- **[Video to Social Post](https://apify.com/agentx/video-to-social-post)** — video repurposed into social copy
- **[YouTube Transcript](https://apify.com/agentx/youtube-transcript)** — YouTube transcripts
- **[TikTok Transcript](https://apify.com/agentx/tiktok-transcript)** — TikTok transcripts
- **[X Twitter Transcript](https://apify.com/agentx/x-twitter-transcript)** — X video transcripts
- **[Facebook Transcript](https://apify.com/agentx/facebook-transcript)** — Facebook video transcripts
- **[Bilibili Transcript](https://apify.com/agentx/bilibili-transcript)** — Bilibili transcripts
- **[Dailymotion Transcript](https://apify.com/agentx/dailymotion-transcript)** — Dailymotion transcripts
- **[Rutube Transcript](https://apify.com/agentx/rutube-transcript)** — Rutube transcripts
- **[Loom Transcript](https://apify.com/agentx/loom-transcript)** — Loom transcripts
- **[Wistia Transcript](https://apify.com/agentx/wistia-transcript)** — Wistia transcripts
- **[Instagram Reels Downloader](https://apify.com/agentx/instagram-reels-downloader)** — Reels downloads
- **[Kick Clip Downloader](https://apify.com/agentx/kick-clip-downloader)** — Kick clip downloads
- **[Linkedin Video Downloader](https://apify.com/agentx/linkedin-video-downloader)** — LinkedIn video downloads
- **[Pinterest Video Downloader](https://apify.com/agentx/pinterest-video-downloader)** — Pinterest video downloads
- **[Reddit Video Downloader](https://apify.com/agentx/reddit-video-downloader)** — Reddit video downloads
- **[Snapchat Video Downloader](https://apify.com/agentx/snapchat-video-downloader)** — Snapchat video downloads
- **[TED Talk Downloader](https://apify.com/agentx/ted-talk-downloader)** — TED talk downloads
- **[TikTok Live Downloader](https://apify.com/agentx/tiktok-live-downloader)** — TikTok live downloads
- **[Twitch VOD Downloader](https://apify.com/agentx/twitch-vod-downloader)** — Twitch VOD downloads
- **[Zoom Recording Downloader](https://apify.com/agentx/zoom-recording-downloader)** — Zoom recording downloads

#### E-Commerce and Retail

- **[All Shopping Scraper](https://apify.com/agentx/all-shopping-scraper)** — multi-platform product data
- **[AliExpress Product Scraper](https://apify.com/agentx/aliexpress-product-scraper)** — AliExpress products
- **[Amazon Storefront Scraper](https://apify.com/agentx/amazon-storefront-scraper)** — Amazon Brand Store pages
- **[Bol Product Scraper](https://apify.com/agentx/bol-product-scraper)** — Bol.com products
- **[eBay Seller Leads API](https://apify.com/agentx/ebay-seller-leads-api)** — eBay seller records
- **[Hepsiburada Product Scraper](https://apify.com/agentx/hepsiburada-product-scraper)** — Hepsiburada products
- **[Kakaku Product Scraper](https://apify.com/agentx/kakaku-product-scraper)** — Kakaku.com products
- **[Rakuten Product Scraper](https://apify.com/agentx/rakuten-product-scraper)** — Rakuten products

#### Classifieds and Automotive

- **[All Vehicle Scraper](https://apify.com/agentx/all-vehicle-scraper)** — multi-platform vehicle listings
- **[AutoTrader Vehicle Search](https://apify.com/agentx/autotrader-vehicle-search)** — AutoTrader US listings
- **[AutoTrader UK Vehicle Search](https://apify.com/agentx/autotrader-uk-vehicle-search)** — AutoTrader UK listings

#### Real Estate

- **[All Property Scraper](https://apify.com/agentx/all-property-scraper)** — multi-platform property listings
- **[Homes Property Scraper](https://apify.com/agentx/homes-property-scraper)** — Homes.com listings
- **[MagicBricks Property Scraper](https://apify.com/agentx/magicbricks-property-scraper)** — MagicBricks listings
- **[NoBroker Property Scraper](https://apify.com/agentx/nobroker-property-scraper)** — NoBroker listings
- **[Property24 Property Scraper](https://apify.com/agentx/property24-property-scraper)** — Property24 listings
- **[Realtor Property Scraper](https://apify.com/agentx/realtor-property-scraper)** — Realtor.com listings
- **[Zillow Property Scraper](https://apify.com/agentx/zillow-property-scraper)** — Zillow listings

### Support and Community

Ask about Reddit profiles, activity depth, billing, and exports in the [AgentX community on Telegram](https://t.me/Apify_Actor); for a reproducible bug, open an Issue with the run ID and exact input.

AgentX is an Arcyton brand — [arcyton.com](https://arcyton.com).

**Last Updated:** August 15, 2026

# Actor input Schema

## `username` (type: `string`):

Reddit account to look up. Accepts a plain username, a u/ prefix, or a full profile URL — 'spez', 'u/spez' and 'https://www.reddit.com/user/spez/' all resolve to the same account.

## `max_posts` (type: `integer`):

Posts to return, minimum 0 and no upper limit. Reddit's own submissions listing stops near 1,000 entries however many the account has — measured across accounts from 1 to 35,000 submissions — so asking for more returns everything Reddit will serve. Set 0 to skip posts entirely.

## `max_comments` (type: `integer`):

Comments to return, minimum 0 and no upper limit. Reddit's listing reaches roughly 10,000 comments, and only with the second sort pass this actor makes; asking for more returns everything it will serve. Set 0 to skip comments entirely.

## Actor input object example

```json
{
  "username": "spez",
  "max_posts": 1,
  "max_comments": 1
}
```

# Actor output Schema

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

Reddit profiles with account facts, stored media, and the requested post and comment collections.

# 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 = {
    "username": "spez",
    "max_posts": 1,
    "max_comments": 1
};

// Run the Actor and wait for it to finish
const run = await client.actor("agentx/reddit-profile-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 = {
    "username": "spez",
    "max_posts": 1,
    "max_comments": 1,
}

# Run the Actor and wait for it to finish
run = client.actor("agentx/reddit-profile-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 '{
  "username": "spez",
  "max_posts": 1,
  "max_comments": 1
}' |
apify call agentx/reddit-profile-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,agentx/reddit-profile-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/bb0YV0rZPcvyB4fX8/builds/9w1FLIBk7PZ0hTWcc/openapi.json