Primary colour
primaryColor
Optional
Main colour of the community theme.
Reddit Scraper — Posts, Comments, Communities & Users
Pricing
from $0.07 / 1,000 posts
Scrape Reddit posts, full comment threads, communities and user profiles by community, keyword, user or URL. 179 fields per row including score, upvote ratio and flair. Export to JSON, CSV or Excel.
Pricing
from $0.07 / 1,000 posts
Rating
0.0
(0)
Developer
Nice Dev
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
2 days ago
Last modified
Categories
Share
Row type
dataType
Required
post, comment, community or user.
ID
id
Required
Reddit id of the item, without its type prefix.
Full ID
fullId
Required
Reddit id with its type prefix: t3_ post, t1_ comment, t5_ community, t2_ user.
URL
url
Required
Public page of the item on reddit.com.
Permalink
permalink
Optional
Path of the item on reddit.com, without the domain.
Post URL
postUrl
Optional
On a comment, the page of the post it belongs to. Equal to URL on a post.
Title
title
Optional
Post title, or community title. Null on comments.
Text
body
Optional
Self-post text or comment text, as plain text. Empty on link posts.
Text (HTML)
bodyHtml
Optional
Same text with Reddit's HTML markup kept.
Post title
postTitle
Optional
On a comment, the title of the post it belongs to, so the row reads on its own.
Post author
postAuthor
Optional
On a comment, the author of the post it belongs to.
Post score
postScore
Optional
On a comment read with its thread, the score of the post it belongs to.
Post type
postType
Optional
text, link, image, gallery, video or poll.
Content categories
contentCategories
Optional
Topic tags Reddit puts on the post.
Discussion type
discussionType
Optional
CHAT on a live chat post, null on a normal one.
Written by the original poster
isSubmitter
Optional
True on a comment written by the author of the post.
Posted as
distinguished
Optional
moderator or admin when the item carries that badge, null otherwise.
Community
subreddit
Optional
Community name without the r/ prefix.
Community (prefixed)
subredditPrefixed
Optional
Community name with its r/ prefix.
Community ID
subredditId
Optional
Stable Reddit id of the community, prefixed t5_.
Community members
subredditSubscribers
Optional
Member count at the moment of the run.
Community type
subredditType
Optional
public, restricted, private, archived or user.
Score
score
Optional
Upvotes minus downvotes. Can be negative. Null on a comment while the community hides its score (Reddit serves 1 in its place).
Upvotes
upVotes
Optional
Reddit's own upvote figure. Equal to the score on most items, null when the score is hidden.
Downvotes
downVotes
Optional
Always 0: Reddit has not published downvote counts for years. Kept because competitors expose it.
Upvote ratio
upvoteRatio
Optional
Share of votes that are upvotes, between 0 and 1. Posts only.
Score hidden
scoreHidden
Optional
True while the community hides the score of a fresh item.
Comments
numComments
Optional
Number of comments on the post, as counted by Reddit.
Crossposts
numCrossposts
Optional
How many times the post was reposted to another community.
Duplicates
numDuplicates
Optional
How many other posts point at the same link.
Awards
totalAwards
Optional
Number of awards the item received.
Gildings
gilded
Optional
Number of gold awards.
Award names
awards
Optional
Names of the awards the item received.
Controversial
controversiality
Optional
1 when Reddit marks the comment as controversial, 0 otherwise.
Views
viewCount
Optional
Reddit only fills this for a community's own moderators; null here.
Age in hours
ageHours
Optional
Hours between the publication and the moment of the run.
Score per hour
scorePerHour
Optional
Score divided by the age in hours: how fast the item is gaining votes.
Engagement
engagementTotal
Optional
Score plus comments, one number to sort a feed by.
Comments per score point
commentToScoreRatio
Optional
Comments divided by score: high means the item is argued over rather than simply liked.
Title length
titleLength
Optional
Characters in the title.
Text length
bodyLength
Optional
Characters in the text.
Word count
wordCount
Optional
Words in the text.
Outbound host
outboundUrlHost
Optional
Host of the link the post points to, without the path.
Flair
flair
Optional
Tag the community puts on the post.
Flair colour
flairBackgroundColor
Optional
Background colour of that tag.
Adult content
isNsfw
Optional
True when the item is marked NSFW.
Marked as spoiler
isSpoiler
Optional
Pinned
isStickied
Optional
True on the announcement posts moderators pin at the top of a community.
Locked
isLocked
Optional
True when no new comment can be added.
Archived
isArchived
Optional
True on old posts Reddit has frozen.
Hidden
isHidden
Optional
Always false on an anonymous read.
Quarantined
isQuarantined
Optional
True when Reddit has put the community behind a warning.
Original content
isOriginalContent
Optional
True when the author tagged the post OC.
Text post
isSelf
Optional
True when the post is text rather than a link.
Video post
isVideo
Optional
Gallery post
isGallery
Optional
Meta post
isMeta
Optional
Can be crossposted
isCrosspostable
Optional
Indexable
isRobotIndexable
Optional
False when Reddit asks search engines to ignore the item, which happens on removed content.
Promoted post
isCreatedFromAdsUi
Optional
True when the post was created through Reddit's advertising tools.
Contest mode
contestMode
Optional
True when the community hides scores and shuffles comments.
Live comments
allowLiveComments
Optional
Media only
mediaOnly
Optional
Replies to inbox
sendReplies
Optional
Nofollow links
noFollow
Optional
Pinned to profile
pinned
Optional
True when the author pinned the post to their own profile.
Collapsed
collapsed
Optional
True when Reddit folds the comment by default.
Collapsed because
collapsedReason
Optional
Why the comment is folded: low score, deleted, crowd control.
Cannot reply because
unrepliableReason
Optional
Why replying is refused: locked, archived, deleted.
Removed by
removedByCategory
Optional
deleted, moderator, automod_filtered or reddit. Null when the item is live.
Removal reason
removalReason
Optional
Public reason for the removal, when the community gives one.
Ban reason
banReason
Optional
Reason a moderator recorded. Rarely public.
Moderator note
modReasonTitle
Optional
Note a moderator attached to the item. Rarely public.
Suggested comment order
suggestedSort
Optional
Comment order the community asks clients to use.
Post ID
postId
Optional
On a comment, the id of the post it belongs to. Null on posts.
Parent ID
parentId
Optional
On a comment, what it replies to: t3_ for the post, t1_ for another comment. Use it with depth to rebuild the thread.
Parent kind
parentKind
Optional
post when the comment answers the post, comment when it answers another comment.
Reply depth
depth
Optional
0 for a top-level comment, 1 for a reply to it, and so on. Empty for a reply read in a user's comment list: Reddit gives the depth in the thread only.
Direct replies
replyCount
Optional
How many comments answer this one directly. Empty for a comment read in a user's comment list.
Link domain
domain
Optional
Host the post links to, or self. for a text post.
Outbound link
linkUrl
Optional
Address the post points to. Equal to the Reddit page on a text post.
Resolved link
urlOverriddenByDest
Optional
Final address after Reddit's own redirect, when it differs.
Thumbnail
thumbnail
Optional
Small preview image. Null when Reddit shows none.
Images
images
Required
Every image of the post at its largest size, gallery included. Empty when the post has none.
[ "https://i.redd.it/abc.jpg"]Gallery images
galleryCount
Optional
How many images the gallery holds. Empty when the post is not a gallery.
Video
videoUrl
Optional
Address of the hosted video when the post has one.
Video length
videoDuration
Optional
Length of the hosted video in seconds.
Has media
hasMedia
Optional
True when the post carries an image, a gallery or a video.
Media type
mediaType
Optional
image, gallery, video, embed or none.
Media (raw)
media
Optional
Reddit's own media object, kept whole for embeds from YouTube, Twitter and the like.
Gallery metadata
mediaMetadata
Optional
Reddit's per-image metadata for a gallery: sizes, types, captions.
Preview (raw)
preview
Optional
Reddit's preview object with every resolution it generated.
Published at
publishedAt
Optional
Creation date, ISO 8601 UTC. This is the date the Posted after and Posted before filters read.
Edited at
editedAt
Optional
Date of the last edit, ISO 8601 UTC. Null when the item was never edited.
Edited
isEdited
Optional
True when the item was edited after posting.
Name
name
Optional
Community name on a community row, username on a user row.
Display name
displayName
Optional
Name the community shows in its header.
Description
description
Optional
Full sidebar description of the community.
Description (HTML)
descriptionHtml
Optional
Same description with Reddit's markup kept.
Short description
publicDescription
Optional
One-line description the community shows in search results.
Short description (HTML)
publicDescriptionHtml
Optional
Members
membersCount
Optional
Community subscriber count.
Community icon
communityIcon
Optional
Header title
headerTitle
Optional
Tooltip the community sets on its header image.
Primary colour
primaryColor
Optional
Main colour of the community theme.
Language
lang
Optional
Language the community declares.
Advertiser category
advertiserCategory
Optional
Category Reddit files the community under for advertising.
Allowed submissions
submissionType
Optional
any, link or self.
Posting guidelines
submitText
Optional
Text the community shows above the post form.
Suggested comment order
suggestedCommentSort
Optional
Comment order the community asks clients to use.
Images allowed
allowImages
Optional
Videos allowed
allowVideos
Optional
Video GIFs allowed
allowVideogifs
Optional
Galleries allowed
allowGalleries
Optional
Polls allowed
allowPolls
Optional
Listed in discovery
allowDiscovery
Optional
Spoiler tag enabled
spoilersEnabled
Optional
Post flairs enabled
linkFlairEnabled
Optional
OC tag enabled
originalContentTagEnabled
Optional
Wiki enabled
wikiEnabled
Optional
Posting restricted
restrictPosting
Optional
Commenting restricted
restrictCommenting
Optional
Accepts followers
acceptFollowers
Optional
Original content only
allOriginalContent
Optional
Score hidden for (minutes)
commentScoreHideMins
Optional
How long the community hides the score of a fresh comment.
Rules
rules
Optional
The title of each rule of the community, in order — with Include rules of communities; null without it.
Rules in full
ruleDetails
Optional
With Include rules of communities: each rule with its title, text, place in the order (0 = first), what it applies to (post, comment or all), the reason shown when reporting it, and its date; null without it.
Wiki page names
wikiPageNames
Optional
With Include wiki of communities: the name of every page of the community's wiki, [] when it has none; null without the option.
Wiki pages
wikiPages
Optional
With Include wiki of communities: each wiki page read, with its name, link, text (Markdown), whole length in characters, whether it was cut, and its last edit (date and author).
Pinned posts
stickiedPosts
Optional
With Include pinned posts of communities: the posts pinned at the top of the community, with id, title, link, author, date, score and comments; [] when none; null without the option.
Similar communities
similarCommunities
Optional
With Include similar communities: the communities Reddit recommends next to this one (up to 10), with name, id, title, link, members, description, adult or not and creation date; [] when none; null without the option.
AI analysis
aiAnalysis
Optional
With Analyze rows with AI, on a post or comment row: sentiment, sentimentScore (-1 to 1), intent, topics, summary, language, labels (your labels, true / false) and the model; null without the option or when the analysis failed.
Username
username
Optional
Username without the u/ prefix.
Total karma
totalKarma
Optional
Post karma
linkKarma
Optional
Comment karma
commentKarma
Optional
Awardee karma
awardeeKarma
Optional
Karma earned from awards received.
Awarder karma
awarderKarma
Optional
Karma earned from awards given.
Premium account
isGold
Optional
Moderator
isMod
Optional
True when the account moderates at least one community.
Reddit employee
isEmployee
Optional
Verified
isVerified
Optional
Verified email
hasVerifiedEmail
Optional
Hidden from search engines
hideFromRobots
Optional
True when the user asked search engines to skip their profile.
Avatar
iconImg
Optional
Snoovatar
snoovatarImg
Optional
Full-body avatar, when the user made one.
Profile title
profileTitle
Optional
Profile bio
profileDescription
Optional
Created at
createdAt
Optional
Creation date of the community or of the user account, ISO 8601 UTC.
Awards (raw)
allAwardings
Optional
Reddit's own award objects, with the name, icon and count of each.
Top award
topAwardedType
Optional
Kind of the highest award the item received.
Secure media (raw)
secureMedia
Optional
HTTPS version of Reddit's media object, used for embeds.
Gallery (raw)
galleryData
Optional
Reddit's gallery object: the ordered list of image ids and their captions.
Crosspost source
crosspostParent
Optional
The original post, when this one is a crosspost of it.
Content hint
postHint
Optional
Reddit's own guess at the link type: image, hosted:video, rich:video or link.
Banned by
bannedBy
Optional
Moderator who removed the item. Only visible to that community's moderators, so null here.
Approved by
approvedBy
Optional
Moderator who approved the item. Moderators only, so null here.
Moderator note
modNote
Optional
Note attached by a moderator. Moderators only, so null here.
Ad eligibility
whitelistStatus
Optional
How Reddit files the item for advertising, for example all_ads or promo_adult_nsfw.
Treatment tags
treatmentTags
Optional
Internal Reddit tags for special display treatments.
Flair class
flairCssClass
Optional
CSS class the community gives the post tag.
Community header image
headerImg
Optional
Community key colour
keyColor
Optional
Community mobile banner
mobileBannerImage
Optional
Emojis enabled
emojisEnabled
Optional
Previous usernames
previousNames
Optional
Names the account used before. Empty for most accounts.
Suspended
isSuspended
Optional
On a user profile: the account is suspended by Reddit.
Trophies
trophies
Optional
On a user profile with "Include trophies": each trophy with its name, description, date and icon.
Profile URL
profileUrl
Optional
Public profile page of the user.
Bio
bio
Optional
Short text the user wrote on their profile.
Cake day
isCakeDay
Optional
True when today is the account's anniversary.
Has subscribed
hasSubscribed
Optional
Whether the account ever joined a community. Reddit only fills it for the logged-in user.
Flair text colour
flairTextColor
Optional
Colour of the text of the post flair: dark or light.
Flair type
flairType
Optional
How the post flair is written: text, or richtext (text with emoji).
Flair (rich text)
flairRichtext
Optional
The post flair as Reddit stores it: its pieces of text and emoji, with the image of each emoji.
Flair template id
flairTemplateId
Optional
Id of the flair the community defined, the same on every post that wears it.
Predictions allowed
allowPredictions
Optional
Members can post predictions.
Prediction contributors
allowPredictionContributors
Optional
Approved members can create predictions.
Prediction tournaments
allowPredictionsTournament
Optional
The community runs prediction tournaments.
Talks allowed
allowTalks
Optional
Live audio talks are allowed.
Media in comments
allowedMediaInComments
Optional
What a comment may carry besides text: giphy, static, animated, video…
Comment settings
commentContributionSettings
Optional
What members may attach to their comments, as Reddit stores it.
Header size
headerSize
Optional
Width and height of the header image, in pixels.
Icon size
iconSize
Optional
Width and height of the community icon, in pixels.
Emoji size
emojisCustomSize
Optional
Width and height of the custom emoji, in pixels.
Deleted comments collapsed
collapseDeletedComments
Optional
Deleted and removed comments are folded away.
Community reviewed
communityReviewed
Optional
Reddit has reviewed the community.
No contributor requests
disableContributorRequests
Optional
Members cannot ask to become approved contributors.
Free-form reports
freeFormReports
Optional
Members can report with their own words.
Menu widget
hasMenuWidget
Optional
The community has a menu widget. Empty for a community found by a search or a directory: Reddit says false there for all.
Ads hidden
hideAds
Optional
Ads are hidden in the community.
Crossposting allowed
isCrosspostableSubreddit
Optional
Posts of the community can be crossposted.
Public traffic stats
publicTraffic
Optional
The traffic statistics of the community are public.
Old posts archived
shouldArchivePosts
Optional
Posts are archived after six months.
Media-in-comments setting shown
shouldShowMediaInCommentsSetting
Optional
The setting for media in comments is offered.
Media shown
showMedia
Optional
Media are shown in the feed.
Media previews
showMediaPreview
Optional
Previews of media are shown.
User flair enabled
userFlairEnabledInSr
Optional
Members can wear a user flair. Empty for a community found by a search or a directory: Reddit says false there for all.
Members set post flair
canAssignLinkFlair
Optional
Members can choose the flair of their posts.
Members set user flair
canAssignUserFlair
Optional
Members can choose their own user flair.
Post flair position
linkFlairPosition
Optional
Where the post flair is shown: left or right.
User flair position
userFlairPosition
Optional
Where the user flair is shown: left or right.
Link button label
submitLinkLabel
Optional
Custom label of the button to submit a link.
Text button label
submitTextLabel
Optional
Custom label of the button to submit a text post.
Submission rules (HTML)
submitTextHtml
Optional
The text shown to members before they post, in HTML.
Rank
rank
Optional
Position of the row in its source, as Reddit ordered it (1 = first result of page 1); empty for a comment read in its thread and for a row read on its own page.
Search term
searchTerm
Optional
Term that found this row. Null when the row comes from a community feed or a pasted URL.
Source
sourceUrl
Optional
Feed or search page the row was read from, so any row can be traced back to its origin.
Custom labels
customLabels
Optional
The key/value pairs given in the input, copied onto every row.
Scraped at
scrapedAt
Required
ISO 8601 timestamp of the extraction.
Comments per hour
commentsPerHour
Optional
Comments divided by the age in hours.