ToolzerHub Docs

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
GET
/v1/reddit/post-details

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.

Lengthlength <= 300
post_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.

Lengthlength <= 500
curl -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"  }}