Start with a defensible sample
Sentiment analysis is only as useful as the source selection. Define the topic, communities, date window, and reason each thread belongs in the sample before collecting comments.
The actor accepts direct public post URLs, not subreddit listing pages or Reddit search pages. Keep the source list with the exported dataset so later readers can understand what the analysis represents.
Choose comment sorting intentionally
Use top or best when the goal is to study prominent community responses, new for a recent reaction window, controversial for polarized discussion, or old when chronology matters. Sorting changes which rows appear when maxComments caps the result.
Keep includeReplies enabled when conversational context matters. Use maxCommentDepth to limit how far nested discussions are followed and commentDepth, commentPath, parentPath, and parentCommentId to reconstruct the hierarchy.
Export the right fields
For a flat sentiment table, keep postUrl, postTitle, subreddit, commentText, commentScore, commentTimestamp, commentDepth, isTopLevel, isPostAuthor, and scrapedAt. Preserve commentId and commentPermalink in the raw export for traceability and deduplication.
CSV works well for spreadsheets, pandas, and most BI tools. JSON is safer when downstream code needs the complete schema or thread identifiers without flattening.
Clean before classifying
Remove empty or deleted comments, deduplicate stable commentId values, keep language detection separate from sentiment, and decide how to handle quotes, links, sarcasm, and very short replies.
Do not interpret commentScore as sentiment. It is a public voting signal and can be analyzed separately from positive, negative, neutral, or topic labels.
Interpret the result with limits
Reddit communities are not representative samples of the general population. Report which posts and subreddits were included, how comments were sorted, how many rows were collected, and which classifier or review process produced each label.
Use the dataset for research and product decisions, not harassment, spam, identity inference, or unlawful profiling.