Logo

Reddit

Authentication Type: Password
Description: Extract Reddit posts and comments with comprehensive metadata. Provide Reddit Client ID as username and Client Secret as password for authenticated access (600 req/min) or leave empty for unauthenticated access (60 req/min).


Posts

Extract Reddit post content and metadata.

Extract Reddit Post

Extract Reddit post data including title, content, metadata, and post statistics. Does not include comments - use the comments extraction for that. Optionally provide a custom User-Agent string to identify your application to Reddit.

Operation Type: Mutation (Write)

Parameters:

  • url string (required): Reddit post URL (e.g., https://reddit.com/r/subreddit/comments/...)
  • useAuth boolean (nullable): Whether to use authenticated API access for higher rate limits (default: true)
  • userAgent string (nullable): Custom User-Agent string for Reddit API requests (default: "Cotera Reddit Tool/1.0")

Returns:

  • content object: Reddit post content
    • title string: Post title
    • selftext string: Post body text (for text posts)
    • url string: Post URL (original link or Reddit URL)
    • isSelfPost boolean: Whether this is a text post vs external link
    • postHint string: Type hint for post content (e.g., "image", "link")
    • domain string: Domain of the external URL
    • mediaType string: Type of media content
    • crosspostParent string (nullable): ID of parent post if this is a crosspost
  • metadata object: Reddit post metadata
    • id string: Reddit post ID
    • name string: Reddit post full name
    • author string: Post author username
    • subreddit string: Subreddit name
    • permalink string: Permanent link to the post
    • createdUtc string: ISO timestamp when post was created
    • score number: Post score (upvotes minus downvotes)
    • upvoteRatio number: Ratio of upvotes to total votes
    • numComments number: Total number of comments
    • gilded number: Number of gold awards
    • totalAwardsReceived number: Total awards received
    • stickied boolean: Whether post is stickied
    • locked boolean: Whether comments are locked
    • archived boolean: Whether post is archived
    • spoiler boolean: Whether post is marked as spoiler
    • nsfw boolean: Whether post is marked NSFW
  • extractionInfo object: Extraction metadata
    • authenticated boolean: Whether API request was authenticated
    • rateLimit string: Rate limit information
    • extractedAt string: ISO timestamp when data was extracted

Example Usage:

{
  "url": "https://reddit.com/r/programming/comments/abc123/interesting_post/",
  "useAuth": true,
  "userAgent": "MyApp/1.0"
}

Comments

Extract Reddit comments with configurable depth and analytics.

Extract Reddit Comments

Extract Reddit comments with configurable nesting depth, including comment statistics, top comments per level, and author participation analytics. Optionally provide a custom User-Agent string to identify your application to Reddit.

Operation Type: Mutation (Write)

Parameters:

  • url string (required): Reddit post URL (e.g., https://reddit.com/r/subreddit/comments/...)
  • maxCommentDepth number (nullable): Maximum comment nesting depth to extract (default: 3)
  • useAuth boolean (nullable): Whether to use authenticated API access for higher rate limits (default: true)
  • userAgent string (nullable): Custom User-Agent string for Reddit API requests (default: "Cotera Reddit Tool/1.0")

Returns:

  • comments object: Comments organized by level (level_0, level_1, etc.)
    • Each level contains an array of comment objects:
      • id string: Comment ID
      • name string: Comment full name
      • parentId string: Parent comment/post ID
      • level number: Nesting level (0 = top level)
      • author string: Comment author username
      • body string: Comment text content
      • bodyHtml string: Comment HTML content
      • createdUtc string: ISO timestamp when comment was created
      • score number: Comment score
      • gilded number: Number of gold awards
      • stickied boolean: Whether comment is stickied
      • permalink string: Permanent link to comment
      • depth number: Comment depth in thread
  • commentStatistics object: Comment statistics and analytics
    • totalComments number: Total number of comments extracted
    • commentsByLevel object: Number of comments at each nesting level
    • averageScoreByLevel object: Average score for comments at each level
    • topCommentByLevel object: Top comment at each nesting level
    • authorParticipation object: Comment participation by author
  • extractionInfo object: Extraction metadata
    • authenticated boolean: Whether API request was authenticated
    • rateLimit string: Rate limit information
    • extractedAt string: ISO timestamp when data was extracted
    • maxCommentDepth number: Maximum comment nesting depth extracted

Example Usage:

{
  "url": "https://reddit.com/r/programming/comments/abc123/interesting_post/",
  "maxCommentDepth": 5,
  "useAuth": true,
  "userAgent": "MyApp/1.0"
}

Authentication Info

Get information about Reddit API authentication status and capabilities.

Get Authentication Info

Check Reddit API credential status, available authentication methods, and rate limits. Helps determine if authenticated or unauthenticated access should be used.

Operation Type: Query (Read)

Parameters:

  • None

Returns:

  • hasCredentials boolean: Whether Reddit API credentials are configured
  • authMethod enum: Available authentication method ("oauth" or "unauthenticated")
  • rateLimit string: Rate limit for the current authentication method
  • recommendedAuth boolean: Whether authenticated access is recommended

Example Usage:

{}

Common Use Cases

Content Analysis:

  • Extract Reddit posts for sentiment analysis and content research
  • Analyze post engagement metrics and community response
  • Track post performance across different subreddits

Comment Mining:

  • Extract comment threads for discussion analysis
  • Analyze comment sentiment and author participation
  • Track conversation patterns and engagement levels

Research and Monitoring:

  • Monitor specific subreddits for relevant discussions
  • Extract data for academic research on social media trends
  • Analyze community reactions to events or announcements