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
- title
- 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
- id
- extractionInfo
object
: Extraction metadata- authenticated
boolean
: Whether API request was authenticated - rateLimit
string
: Rate limit information - extractedAt
string
: ISO timestamp when data was extracted
- authenticated
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
- id
- Each level contains an array of comment objects:
- 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
- totalComments
- 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
- authenticated
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