Get post (v1)
Get a post in the same shape as a feed row, with Reddit's comment total. Takes the post's permalink, or its id with subreddit.
1 credit / requestBilled only on success
Authorization
ApiKeyAuth x-api-key<token>
In: header
Query Parameters
subreddit?string
Community the post belongs to, e.g. technology. Needed only when post_id_or_url is a bare id; a permalink names it already. It must match the post: a mismatch returns a 500.
Length
length <= 300post_id_or_url*string
The post's reddit.com permalink, or its id (1vqcqpz) or t3_ fullname with subreddit. A temporary failure returns a retryable 503.
Length
length <= 500curl -X GET "https://example.com/v1/reddit/post-details?post_id_or_url=https%3A%2F%2Fwww.reddit.com%2Fr%2Ftechnology%2Fcomments%2F1vqcqpz%2Fsome_slug%2F" \ -H "x-api-key: YOUR_API_KEY"{ "data": { "id": "1vay198", "fullname": "t3_1vay198", "permalink": "/r/technology/comments/1vay198/example_post_title/", "url": "https://www.reddit.com/r/technology/comments/1vay198/example/", "title": "Example post title", "subreddit": "technology", "subreddit_prefixed": "r/technology", "subreddit_id": "t5_2qh16", "author": "example_user", "author_id": "t2_abc123", "author_icon": null, "created_at": "2026-08-17T09:14:22.000+0000", "score": 1284, "upvote_ratio": 0.94, "comment_count": 213, "award_count": 0, "domain": "arstechnica.com", "content_url": "https://arstechnica.com/example-article/", "post_type": "link", "flair": "Society", "flair_url": "/r/technology/?f=flair_name%3A%22Society%22", "thumbnail": "https://external-preview.redd.it/example.jpg", "media": { "kind": "image", "url": "https://i.redd.it/example.jpeg", "poster": null, "preview": null, "caption_url": null, "items": null }, "text": null, "nsfw": null, "spoiler": false, "locked": false, "archived": false, "language": "en", "total_comments": 226, "usage_note": "Assembled from two requests: the comment-tree fragment for the canonical permalink and the comment total, then the post page for the record itself. Both are needed — the permalink's SLUG is load-bearing (the same post id without its slug answers 500 with an empty body), and post metadata exists nowhere but the page. `score` is live and drifts between consecutive fetches. `nsfw` is null unless the post is an image post: it is not an attribute on the post element and the only signal in the markup rides on an element image posts alone carry, so null means the page did not say rather than false." }, "details": { "reason": "no_results", "message": "string" }}