Reddit API: Get post

Get a post in the same shape as a feed row, with Reddit's comment total. subreddit and post_id must refer to the same post.

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. Accepts r/technology or a URL. It must match the post; a mismatch returns a 500, so pasting the post's permalink into post_id is safest.

Lengthlength <= 300

post_id*string

Post id (1vqcqpz), t3_ fullname, or permalink. Prefer the permalink. A temporary failure returns a retryable 503.

Lengthlength <= 500

curl -X GET "https://example.com/v1/reddit/post-details?subreddit=technology&post_id=1vqcqpz" \  -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."  }}