Reddit

Search Reddit Comments

Search for Reddit comments by keyword across all subreddits, or in one subreddit. Returns comment text, the comment, post and parent IDs, a link to the comment, a link for the parent post, subreddit, author, comment upvotes, and parent post engagement metrics. Supports fetching multiple pages in a single API call (billed per page). AutoModerator comments are filtered out, and comments are matched against your query text, so a page can return fewer results than the page size. The url field points at the parent post and can be an off-site link when the post links to another domain. upvotes is null when the comment score is hidden, and post_upvotes / post_comments are null when the parent post's metrics are unavailable.

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

get/v1/reddit/comments

Request

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

Query parameters

querystring required

Search query (max 500 characters)

pagesinteger

Number of pages to fetch and merge (1-10). Billed per page.

sort_by'most_recent' | 'relevance' | 'top'

Sort order for results

subredditstring

Only return comments from this subreddit, with or without r/ (e.g. Python).

get_sentimentboolean

Set to true to add AI emotion analysis to each comment (returned in the posts 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

pagesnumber nullable
countnumber nullable

Changes

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