How to Scrape Reddit Post Comments
This tutorial shows how to use Reddit Post Comments API to scrape and crawl structured Reddit data in real-time.
Extract full Reddit comment trees through our API and capture top-level replies, nested threads, upvote scores, and author data for deep sentiment analysis and community research.
Access Reddit Data in 3 Steps
Start crawling Reddit post comments data. Follow these steps to extract social media data in minutes.
1
Create Your Account
Go to our registration page and make an account. It's free, no credit card, and you get credits right away to play around with.
2
Verify Your Email Address
You'll get a verification email, click the link in it. Once that's done, you can grab your API token from the dashboard.
3
Make Your First API Call
Copy the code snippet below, swap in your API key, and run it. You'll get Reddit data back as JSON within a few seconds.
Code Sample
Here's a JavaScript example to get you going. Swap out the token and you're good, works the same way in any language that can make HTTP requests. Start collecting post comments data via our REST API!
JavaScript Reddit Post Comments
| 1 | const root = 'https://ensembledata.com/apis' |
| 2 | const endpoint = '/reddit/post/comments' |
| 3 | const params = { |
| 4 | "permalink": "/r/SkincareAddiction/comments/8pv3gg/ba_finished_my_5_month_course_of_accutane_just_in/", |
| 5 | "token": "YOUR-TOKEN-HERE" |
| 6 | } |
| 7 | |
| 8 | const queryString = new URLSearchParams(params).toString(); |
| 9 | const url = `${root}${endpoint}?${queryString}`; |
| 10 | |
| 11 | await fetch(url) |
| 12 | .then(response => response.json()) |
| 13 | .then(data => console.log(data)) |
| 14 | .catch(error => console.error(error)); |
| 15 |
Parameters
permalink (string) Post permalink found from the other API. REQUIRED
token (string) Private token assigned to each client to access the APIs. REQUIRED
Example Response
Explore the fields returned by this endpoint. Click a row to expand nested objects and arrays, hover a value to copy it, or use "Expand all" to see everything at once.
JSON
Reddit Post Comments
dataobject1 field
commentsarray1 item · schema from #0 1 item
kindstring"t1"
dataobject70 fields
subreddit_idstring"t5_2tbbg"
approved_at_utcnullnull
author_is_blockedbooleanfalse
comment_typenullnull
awardersarray0 items
empty
mod_reason_bynullnull
banned_bynullnull
author_flair_typestring"text"
total_awards_receivednumber0
subredditstring"SkincareAddiction"
author_flair_template_idnullnull
likesnullnull
repliesobject2 fields
kindstring"Listing"
dataobject6 fields
afternullnull
distnullnull
modhashstring""
geo_filterstring""
childrenarray4 items · schema from #0 4 items
kindstring"t1"
dataobject70 fields
subreddit_idstring"t5_2tbbg"
approved_at_utcnullnull
author_is_blockedbooleanfalse
comment_typenullnull
awardersarray0 items
empty
mod_reason_bynullnull
banned_bynullnull
author_flair_typestring"text"
total_awards_receivednumber0
subredditstring"SkincareAddiction"
author_flair_template_idnullnull
likesnullnull
repliesobject2 fields
kindstring"Listing"
dataobject6 fields
afternullnull
distnullnull
modhashstring""
geo_filterstring""
childrenarray1 item · schema from #0 1 item
kindstring"t1"
dataobject70 fields
subreddit_idstring"t5_2tbbg"
approved_at_utcnullnull
author_is_blockedbooleanfalse
comment_typenullnull
awardersarray0 items
empty
mod_reason_bynullnull
banned_bynullnull
author_flair_typestring"text"
total_awards_receivednumber0
subredditstring"SkincareAddiction"
author_flair_template_idnullnull
likesnullnull
repliesobject2 fields
kindstring"Listing"
dataobject6 fields
afternullnull
distnullnull
modhashstring""
geo_filterstring""
childrenarray1 item · schema from #0 1 item
kindstring"t1"
dataobject70 fields
subreddit_idstring"t5_2tbbg"
approved_at_utcnullnull
author_is_blockedbooleanfalse
comment_typenullnull
awardersarray0 items
empty
mod_reason_bynullnull
banned_bynullnull
author_flair_typestring"text"
total_awards_receivednumber0
subredditstring"SkincareAddiction"
author_flair_template_idnullnull
likesnullnull
repliesobject2 fields
kindstring"Listing"
dataobject6 fields
afternullnull
distnullnull
modhashstring""
geo_filterstring""
childrenarray1 item · schema from #0 1 item
kindstring"t1"
dataobject70 fields
subreddit_idstring"t5_2tbbg"
approved_at_utcnullnull
author_is_blockedbooleanfalse
comment_typenullnull
awardersarray0 items
empty
mod_reason_bynullnull
banned_bynullnull
author_flair_typestring"text"
total_awards_receivednumber0
subredditstring"SkincareAddiction"
author_flair_template_idnullnull
distinguishednullnull
likesnullnull
repliesobject2 fields
kindstring"Listing"
dataobject6 fields
afternullnull
distnullnull
modhashstring""
geo_filterstring""
childrenarray1 item · schema from #0 1 item
kindstring"more"
dataobject6 fields
countnumber1
namestring"t1_huygdri"
idstring"huygdri"
parent_idstring"t1_e0py6tb"
depthnumber5
childrenarray1 item · schema from #0 1 item
0string"h"
1string"u"
2string"y"
3string"g"
4string"d"
5string"r"
6string"i"
beforenullnull
user_reportsarray0 items
empty
savedbooleanfalse
idstring"e0py6tb"
banned_at_utcnullnull
mod_reason_titlenullnull
gildednumber0
archivedbooleanfalse
collapsed_reason_codenullnull
no_followbooleanfalse
authorstring"cbax297"
can_mod_postbooleanfalse
send_repliesbooleantrue
parent_idstring"t1_e0ptnab"
scorenumber30
author_fullnamestring"t2_12fqs5"
removal_reasonnullnull
approved_bynullnull
mod_notenullnull
all_awardingsarray0 items
empty
bodystring"the little cc’s on my forehead and jawline kinda came back and i’ll ge…"
editedbooleanfalse
author_flair_css_classstring"notag"
namestring"t1_e0py6tb"
is_submitterbooleanfalse
downsnumber0
author_flair_richtextarray0 items
empty
author_patreon_flairbooleanfalse
body_htmlstring"<div class="md"><p>the little cc’s on my forehead and jawl…"
gildingsobject0 fields
empty
collapsed_reasonnullnull
link_idstring"t3_8pv3gg"
associated_awardnullnull
stickiedbooleanfalse
author_premiumbooleanfalse
can_gildbooleanfalse
top_awarded_typenullnull
unrepliable_reasonnullnull
author_flair_text_colorstring"dark"
treatment_tagsarray0 items
empty
score_hiddenbooleanfalse
permalinkstring"/r/SkincareAddiction/comments/8pv3gg/ba_finished_my_5_month_course_of_…"
subreddit_typestring"public"
lockedbooleanfalse
report_reasonsnullnull
creatednumber1529075568
author_flair_textstring""
collapsedbooleanfalse
created_utcnumber1529075568
subreddit_name_prefixedstring"r/SkincareAddiction"
controversialitynumber0
depthnumber4
author_flair_background_colorstring""
collapsed_because_crowd_controlnullnull
mod_reportsarray0 items
empty
num_reportsnullnull
upsnumber30
beforenullnull
user_reportsarray0 items
empty
savedbooleanfalse
idstring"e0ptnab"
banned_at_utcnullnull
mod_reason_titlenullnull
gildednumber0
archivedbooleanfalse
collapsed_reason_codenullnull
no_followbooleanfalse
authorstring"quirkyfellows"
can_mod_postbooleanfalse
send_repliesbooleantrue
parent_idstring"t1_e0ezpay"
scorenumber36
author_fullnamestring"t2_hlw0s0m"
removal_reasonnullnull
approved_bynullnull
mod_notenullnull
all_awardingsarray0 items
empty
collapsedbooleanfalse
bodystring"I have the glow right now too!!! How are you post accutane? Has the ac…"
editedbooleanfalse
top_awarded_typenullnull
author_flair_css_classstring"notag"
namestring"t1_e0ptnab"
is_submitterbooleanfalse
downsnumber0
author_flair_richtextarray0 items
empty
author_patreon_flairbooleanfalse
body_htmlstring"<div class="md"><p>I have the glow right now too!!! How ar…"
gildingsobject0 fields
empty
collapsed_reasonnullnull
distinguishednullnull
associated_awardnullnull
stickiedbooleanfalse
author_premiumbooleanfalse
can_gildbooleanfalse
link_idstring"t3_8pv3gg"
unrepliable_reasonnullnull
author_flair_text_colorstring"dark"
score_hiddenbooleanfalse
permalinkstring"/r/SkincareAddiction/comments/8pv3gg/ba_finished_my_5_month_course_of_…"
subreddit_typestring"public"
lockedbooleanfalse
report_reasonsnullnull
creatednumber1529071400
author_flair_textstring""
treatment_tagsarray0 items
empty
created_utcnumber1529071400
subreddit_name_prefixedstring"r/SkincareAddiction"
controversialitynumber0
depthnumber3
author_flair_background_colorstring""
collapsed_because_crowd_controlnullnull
mod_reportsarray0 items
empty
num_reportsnullnull
upsnumber36
beforenullnull
user_reportsarray0 items
empty
savedbooleanfalse
idstring"e0ezpay"
banned_at_utcnullnull
mod_reason_titlenullnull
gildednumber0
archivedbooleanfalse
collapsed_reason_codenullnull
no_followbooleanfalse
authorstring"cbax297"
can_mod_postbooleanfalse
send_repliesbooleantrue
parent_idstring"t1_e0ekyfe"
scorenumber520
author_fullnamestring"t2_12fqs5"
removal_reasonnullnull
approved_bynullnull
mod_notenullnull
all_awardingsarray0 items
empty
bodystring"omg yes i miss the glow my face had while i was on accutane so much!! …"
editedbooleanfalse
top_awarded_typenullnull
downsnumber0
author_flair_css_classstring"notag"
namestring"t1_e0ezpay"
is_submitterbooleanfalse
collapsedbooleanfalse
author_flair_richtextarray0 items
empty
author_patreon_flairbooleanfalse
body_htmlstring"<div class="md"><p>omg yes i miss the glow my face had whi…"
gildingsobject0 fields
empty
collapsed_reasonnullnull
distinguishednullnull
associated_awardnullnull
stickiedbooleanfalse
author_premiumbooleanfalse
can_gildbooleanfalse
link_idstring"t3_8pv3gg"
unrepliable_reasonnullnull
author_flair_text_colorstring"dark"
score_hiddenbooleanfalse
permalinkstring"/r/SkincareAddiction/comments/8pv3gg/ba_finished_my_5_month_course_of_…"
subreddit_typestring"public"
lockedbooleanfalse
report_reasonsnullnull
creatednumber1528602090
author_flair_textstring""
treatment_tagsarray0 items
empty
created_utcnumber1528602090
subreddit_name_prefixedstring"r/SkincareAddiction"
controversialitynumber0
depthnumber2
author_flair_background_colorstring""
collapsed_because_crowd_controlnullnull
mod_reportsarray0 items
empty
num_reportsnullnull
upsnumber520
beforenullnull
user_reportsarray0 items
empty
savedbooleanfalse
idstring"e0ekyfe"
banned_at_utcnullnull
mod_reason_titlenullnull
gildednumber0
archivedbooleanfalse
collapsed_reason_codenullnull
no_followbooleanfalse
authorstring"Mehmeh111111"
can_mod_postbooleanfalse
created_utcnumber1528584691
send_repliesbooleantrue
parent_idstring"t1_e0e90mc"
scorenumber560
author_fullnamestring"t2_xgpym"
removal_reasonnullnull
approved_bynullnull
mod_notenullnull
all_awardingsarray0 items
empty
bodystring"That accutane glow is so real. I miss it. You are positively stunning."
editedbooleanfalse
top_awarded_typenullnull
author_flair_css_classstring"notag"
namestring"t1_e0ekyfe"
is_submitterbooleanfalse
downsnumber0
author_flair_richtextarray0 items
empty
author_patreon_flairbooleanfalse
body_htmlstring"<div class="md"><p>That accutane glow is so real. I miss i…"
gildingsobject0 fields
empty
collapsed_reasonnullnull
distinguishednullnull
associated_awardnullnull
stickiedbooleanfalse
author_premiumbooleanfalse
can_gildbooleanfalse
link_idstring"t3_8pv3gg"
unrepliable_reasonnullnull
author_flair_text_colorstring"dark"
score_hiddenbooleanfalse
permalinkstring"/r/SkincareAddiction/comments/8pv3gg/ba_finished_my_5_month_course_of_…"
subreddit_typestring"public"
lockedbooleanfalse
report_reasonsnullnull
creatednumber1528584691
author_flair_textstring""
treatment_tagsarray0 items
empty
collapsedbooleanfalse
subreddit_name_prefixedstring"r/SkincareAddiction"
controversialitynumber0
depthnumber1
author_flair_background_colorstring""
collapsed_because_crowd_controlnullnull
mod_reportsarray0 items
empty
num_reportsnullnull
upsnumber560
beforenullnull
user_reportsarray0 items
empty
savedbooleanfalse
idstring"e0e90mc"
banned_at_utcnullnull
mod_reason_titlenullnull
gildednumber0
archivedbooleanfalse
collapsed_reason_codenullnull
no_followbooleanfalse
authorstring"synnoreen"
can_mod_postbooleanfalse
created_utcnumber1528571779
send_repliesbooleantrue
parent_idstring"t3_8pv3gg"
scorenumber5290
author_fullnamestring"t2_16n4n6ac"
approved_bynullnull
mod_notenullnull
all_awardingsarray0 items
empty
collapsedbooleanfalse
bodystring"IM JUST SO FUCKING HAPPY FOR YOU. OH MY GOD IM SO EXCITED YOU LOOK BEA…"
editedbooleanfalse
top_awarded_typenullnull
author_flair_css_classstring"notag"
namestring"t1_e0e90mc"
is_submitterbooleanfalse
downsnumber0
author_flair_richtextarray0 items
empty
author_patreon_flairbooleanfalse
body_htmlstring"<div class="md"><p>IM JUST SO FUCKING HAPPY FOR YOU. OH MY…"
removal_reasonnullnull
collapsed_reasonnullnull
distinguishednullnull
associated_awardnullnull
stickiedbooleanfalse
author_premiumbooleanfalse
can_gildbooleanfalse
gildingsobject0 fields
empty
unrepliable_reasonnullnull
author_flair_text_colorstring"dark"
score_hiddenbooleanfalse
permalinkstring"/r/SkincareAddiction/comments/8pv3gg/ba_finished_my_5_month_course_of_…"
subreddit_typestring"public"
lockedbooleanfalse
report_reasonsnullnull
creatednumber1528571779
author_flair_textstring""
treatment_tagsarray0 items
empty
link_idstring"t3_8pv3gg"
subreddit_name_prefixedstring"r/SkincareAddiction"
controversialitynumber0
depthnumber0
author_flair_background_colorstring""
collapsed_because_crowd_controlnullnull
mod_reportsarray0 items
empty
num_reportsnullnull
upsnumber5290
Response Codes
Status codes this endpoint can return, so you can handle errors before they surprise you in production.
200SuccessSuccessful Response
404Client ErrorNot found
422Client ErrorValidation Error
491Client ErrorToken not found
492Client ErrorEmail not verified
493Client ErrorSubscription expired
495Client ErrorAll daily units used
500Server ErrorSomething went wrong
API Pricing
3 units
Cost per successful call to this endpoint.
Fetch Reddit Data at Scale
Pull Reddit comments in bulk including threads, nested replies, and upvotes and use them to inform content strategy, product research, or community feedback analysis.
Full Comment Tree
Get top-level and nested replies for any Reddit post at once.
Upvote Scores
See upvote scores per comment to gauge community sentiment.
Author Data
Get author info returned alongside every comment retrieved.