Reddit User Scraper - Documentation

Overview

The Reddit User Scraper is an Apify Actor that extracts data from Reddit user profiles. You can scrape user profile information, their posts, or their comments with customizable filters and pagination.

What You Can Scrape

This actor supports three types of operations:

1. Profile - Get basic information about a Reddit user
2. Posts - Retrieve posts submitted by a user
3. Comments - Fetch comments made by a user

Input Parameters

Required Parameters

Parameter	Type	Description	Example
userUrl	String	Full Reddit URL of the user to scrape	https://www.reddit.com/user/wsbapp/

Optional Parameters

Parameter	Type	Default	Description
operationType	String	profile	Type of data to scrape: profile, posts, or comments
limit	Integer	25	Number of items to fetch per page (1-100)
page	Integer	1	Page number to fetch (1-50)
sortBy	String	hot	Sort order for posts/comments: hot, new, top, rising, or controversial

How to Use

Example 1: Get User Profile

Input:

{
  "operationType": "profile",
  "userUrl": "https://www.reddit.com/user/wsbapp/"
}

Output:

{
  "success": true,
  "message": "Success",
  "data": {
    "user": {
      "id": "qbvp0eq8b",
      "name": "wsbapp",
      "created": "2023-12-20T07:48:10.000Z",
      "linkKarma": 106831,
      "commentKarma": 176,
      "totalKarma": 107007,
      "isGold": false,
      "isMod": true,
      "verified": true,
      "avatar": "https://www.redditstatic.com/avatars/defaults/v2/avatar_default_3.png",
      "isEmployee": false,
      "hasVerifiedEmail": false,
      "isBanned": false,
      "url": "https://reddit.com/user/wsbapp"
    }
  },
  "error": null
}

Example 2: Get User Posts

Input:

{
  "operationType": "posts",
  "userUrl": "https://www.reddit.com/user/wsbapp/",
  "limit": 25,
  "page": 1,
  "sortBy": "new"
}

Output:

{
  "success": true,
  "message": "Success",
  "data": {
    "username": "wsbapp",
    "page": 1,
    "limit": 25,
    "count": 25,
    "after": "t3_1pult0m",
    "posts": [
      {
        "id": "1q79zu2",
        "title": "Daily Discussion Thread for January 08, 2026",
        "author": "wsbapp",
        "subreddit": "wallstreetbets",
        "score": 138,
        "upvoteRatio": 0.94,
        "numComments": 3570,
        "created": "2026-01-08T12:01:19.000Z",
        "url": "https://www.reddit.com/r/wallstreetbets/comments/1q79zu2/...",
        "permalink": "https://reddit.com/r/wallstreetbets/comments/1q79zu2/...",
        "isVideo": false,
        "isSelf": true,
        "thumbnail": "self",
        "domain": "self.wallstreetbets",
        "gilded": 0,
        "locked": false,
        "spoiler": false,
        "nsfw": false
      }
    ]
  },
  "error": null
}

Example 3: Get User Comments

Input:

{
  "operationType": "comments",
  "userUrl": "https://www.reddit.com/user/wsbapp/",
  "limit": 10,
  "page": 1,
  "sortBy": "hot"
}

Output:

{
  "success": true,
  "message": "Success",
  "data": {
    "username": "wsbapp",
    "page": 1,
    "limit": 10,
    "count": 10,
    "after": "t1_ktj7bqs",
    "comments": [
      {
        "id": "ktjb25r",
        "author": "wsbapp",
        "body": "#Ban Bet Won\n\n/u/Storewars56 made a bet...",
        "score": 45,
        "created": "2024-03-06T00:22:00.000Z",
        "parentId": "t3_1b72tbp",
        "gilded": 0,
        "permalink": "https://reddit.com/r/wallstreetbets/comments/1b72tbp/.../ktjb25r/",
        "url": "https://www.reddit.com/r/wallstreetbets/comments/1b72tbp/...",
        "replies": []
      }
    ]
  },
  "error": null
}

Output Data Structure

Profile Operation

Returns user account information including:

• Account ID and username
• Creation date
• Karma scores (link, comment, and total)
• Account status (verified, mod, employee, banned)
• Avatar URL
• Profile URL

Posts Operation

Returns an array of posts with:

• Post ID and title
• Author and subreddit
• Score and upvote ratio
• Number of comments
• Creation date
• URLs (post URL and permalink)
• Media type indicators (isVideo, isSelf)
• Post status (locked, spoiler, nsfw, gilded)
• Pagination info (page, limit, count, after token)

Comments Operation

Returns an array of comments with:

• Comment ID and author
• Comment text (body)
• Score and gilded count
• Creation date
• Parent post ID
• Permalink and post URL
• Replies array
• Pagination info (page, limit, count, after token)

Tips for Beginners

1. Start with Profile: If you're new, begin with the profile operation to verify the user exists before fetching posts or comments.

2. Pagination: Use the page parameter to fetch more results. Start with page 1, then increment to get older content.

3. Limit Your Requests: Start with a small limit (like 10-25) to test, then increase if needed. Maximum is 100 items per page.

4. Sort Options:

   • Use hot for currently trending content
   • Use new for most recent content
   • Use top for highest-scoring content
   • Use controversial for divisive content

5. Valid User URLs: Make sure your userUrl follows this format: https://www.reddit.com/user/USERNAME/

Error Handling

If the actor encounters an error, the output will include:

{
  "success": false,
  "message": "Error description",
  "data": null,
  "error": "Detailed error message"
}

Common errors:

• Invalid user URL format
• User doesn't exist

Limitations

• Maximum 100 items per page
• Maximum 50 pages per request
• Cannot access private or suspended accounts

Support

For issues, questions, or feature requests, please refer to the Apify platform documentation or:

1. Create an issue and share your resource
2. Send us private message
3. Contact us via Telegram: @pintoflow