---
title: "Get Reddit post"
method: GET
path: "/reddit/post/{id}"
tags: ["Reddit"]
---

# Get Reddit post

`GET /reddit/post/{id}`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/reddit/post/{id}`
- Auth: API key in header `x-api-key`

Returns a public Reddit post. The default mode is 1 credit. Set `include_metrics=true` to return public net score, upvote ratio, comment count, award count, and estimated upvote/downvote totals for 3 credits. Reddit fuzzes voting data, so estimates are approximate; share, repost/crosspost, and view counts are not exposed anonymously. If source.type is redlib, public fields and credit weights are preserved.

## Path parameters

- `id` string, required

## Query parameters

- `include_metrics` boolean

## Headers

- `x-api-key` string, required

## Response `200`

OK

- RedditPostResponseDoc
  - `code` integer
  - `data` RedditPostResponse
    - `metrics_source` RedditSourceDetail
      - `type` string: Kind of Reddit source the data was read from.
      - `url` string: Reddit URL the data was read from.
    - `post` RedditPost
      - `author` RedditAuthor
        - `name` string: Reddit username of the author.
        - `profile_url` string: URL of the author's Reddit profile page.
      - `award_count` integer: Number of awards the post received. Set only when metrics are requested.
      - `comment_count` integer: Number of comments on the post. Set only when metrics are requested.
      - `created` string: Time the post was submitted, in UTC (RFC 3339).
      - `created_utc` integer: Time the post was submitted, in Unix seconds.
      - `domain` string: Domain of the linked content, or `self.<subreddit>` for text posts.
      - `estimated_downvotes` integer: Approximate downvote total worked out from the score and upvote ratio. Reddit does not publish exact counts.
      - `estimated_upvotes` integer: Approximate upvote total worked out from the score and upvote ratio. Reddit does not publish exact counts.
      - `flair` string: Flair text attached to the post.
      - `id` string: Reddit post id.
      - `is_self` boolean: Whether the post is a text post rather than a link.
      - `is_video` boolean: Whether the post is a video.
      - `locked` boolean: Whether the post is locked against new comments.
      - `name` string: Reddit full name of the post, the id prefixed with `t3_`.
      - `over_18` boolean: Whether the post is marked as 18+ content.
      - `permalink` string: Reddit URL of the post's comments page.
      - `score` integer: Net score of the post, upvotes minus downvotes as Reddit shows it. Set only when metrics are requested.
      - `selftext` string: Body text of a text post.
      - `source_feed_url` string: URL of the Reddit feed the post was read from.
      - `stickied` boolean: Whether the post is pinned to the top of its subreddit.
      - `subreddit` string: Name of the subreddit the post belongs to, without `r/`.
      - `thumbnail` string: URL of the post thumbnail image.
      - `title` string: Title of the post as submitted.
      - `upvote_ratio` number: Share of votes that are upvotes, from 0 to 1. Set only when metrics are requested.
      - `url` string: Reddit URL of the post.
      - `vote_counts_estimated` boolean: Whether `estimated_upvotes` and `estimated_downvotes` are estimates.
    - `source` RedditSourceDetail
      - `type` string: Kind of Reddit source the data was read from.
      - `url` string: Reddit URL the data was read from.
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)