Browsable Browsable Docs

Reddit Post & Comments API

Fetch a specific Reddit post along with all its comments and replies.

GET /v1/reddit/post

Parameters

Parameter Type Required Description
url string Yes Valid Reddit post URL (max 2048 characters)
includeComments boolean No Include comments in response (default: true)

Response

Returns the Reddit post data along with comments:

Response Fields
Post Object:
id - Unique Reddit post ID
title - Post title
author - Username of the post author
subreddit - Name of the subreddit
score - Current upvote score
upvoteRatio - Ratio of upvotes to total votes (0-1)
numComments - Total number of comments
created - Unix timestamp of post creation
url - Full URL to the Reddit post
selftext - Text content (if text post)
isVideo - Whether the post is a video
Comment Object:
id - Unique comment ID
author - Username of the comment author
body - Comment text content
score - Comment upvote score
created - Unix timestamp of comment creation
depth - Nesting depth (0 for top-level)
isSubmitter - Whether the commenter is the post author
replies - Array of nested comment objects

Code Examples

Try it Out

API Playground

Stored locally only

Reddit post URL

Include comments (true/false)

Error Codes

400 Bad Request
URL parameter is missing, invalid, or exceeds 2048 characters
401 Unauthorized
Missing or invalid API key
403 Forbidden
Active subscription required
500 Internal Server Error
Failed to fetch Reddit post or comments
Credits: This endpoint deducts credits per request. See Authentication for details.