Reddit

Reddit User Comments

Get a Reddit user's comments by username or profile URL. Sort by newest, hot, top or controversial, with a time window (past hour to all time) for top and controversial. Returns each comment's text, score, date, subreddit and permalink, plus the title and link of the post it was left on, 25 per page, up to about 1,000 comments. Supports fetching multiple pages in a single API call (billed per page).

Price: $0.003 per page. Free tier: 50 requests/month.

get/v1/reddit/user/comments

Request

  • Base URL: https://apidirect.io
  • URL: https://apidirect.io/v1/reddit/user/comments
  • Auth: API key in header X-API-Key

Query parameters

usernamestring

Reddit username, with or without u/ (3-20 characters). Provide exactly one of username or url.

urlstring

Reddit profile URL, e.g. https://www.reddit.com/user/spez (max 500 characters). Provide exactly one of username or url.

sort_by'most_recent' | 'hot' | 'top' | 'controversial'

Sort order: most_recent, hot, top, or controversial (default: most_recent)

posted_ago'1h' | '24h' | '7d' | '30d' | '12m' | 'all'

Time window for sort_by=top or sort_by=controversial: 1h, 24h, 7d, 30d, 12m, or all (default: all). Rejected with any other sort_by.

pagesinteger

Number of pages to fetch, 1-40 (default: 1). Each page returns up to 25 comments.

get_sentimentboolean

Set to true to add AI emotion analysis to each comment (returned in the comments array). Adds a sentiment object containing emotions (joy, trust, fear, surprise, sadness, disgust, anger and anticipation, each scored 0-100), dominant_emotion, emotional_intensity (0-10), and polarity (positive, negative or neutral). Any comment that cannot be scored returns sentiment: null.

Response

Successful response

usernamestring nullable
sort_bystring nullable
pagesnumber nullable
countnumber nullable

Changes

No recorded changes to this operation across all 1 revision of this API.