Skip to content

Get a Reddit post's content and stats

POST/v1/tools/reddit.post.detail/callsNeeds an API key

Returns one Reddit post's title, body, subreddit, author, score and comment count. Use it to read a known post.

Tool reddit.post.detail on Reddit. Contract version 1, released 2026-10-30.

Over REST, send the input in the body. Over MCP, pass the same input to call_tool.

Both return the full response: the call's ID, status and cost, with this tool's result in output.

Input

urlstringRequired

Address of the post, https://www.reddit.com/r/<subreddit>/comments/<post id>/, as the url of a post from reddit.search.posts. reddit.com, old.reddit.com and new.reddit.com work too, over http or https, with or without the title slug, trailing slash, query string or fragment. A redd.it short link does not.

Format uri.

Matches ^https?://(?:(?:www|old|new)\.)?reddit\.com/r/([A-Za-z0-9_]{2,21})/comments/([a-z0-9]{1,20})(?:/[A-Za-z0-9_-]*)?/?(?:[?#]\S*)?$.

Output

A successful call returns these blocks in its output. A field not marked required can be null.

post

One object. Can be null.

idstringRequired

Reddit's full name of the post, t3_ followed by the post id in its address.

urlstringRequired

Address of the post on www.reddit.com.

Format uri.

titlestring
textstring

The body of a text post, in Markdown. Null for a link post.

link_urlstring

Address a link post points at, such as an article or an image. Null for a text post.

subredditstringRequired

Name of the subreddit the post is in, without r/.

flairstring

Text of the post's flair, the label its subreddit gives it.

published_atstring

When the post was published, in ISO 8601.

author_idstring

Reddit's full name of the author's account, t2_ followed by its id.

author_usernamestring

The author's username, without u/.

scoreinteger

Upvotes minus downvotes, as Reddit shows it. Reddit fuzzes it slightly.

upvote_rationumber

Share of the votes that are upvotes, from 0 to 1. Reddit fuzzes it slightly.

comment_countinteger
nsfwboolean

Whether the post is marked NSFW (not safe for work).

spoilerboolean

Whether the post is marked as a spoiler.

lockedboolean

Whether the post is locked to new comments.

stickiedboolean

Whether the post is pinned to the top of its subreddit.