# Reddit Post API (https://www.socialcrawl.dev/platforms/reddit/post)

> Returns a single Reddit post from its URL, including the post BODY (selftext). `content.text` is the title and body joined, matching how posts read on `/v1/reddit/subreddit`; `ext.title` and `ext.selftext` carry the two halves separately. Also returns score, comment count, author, author avatar, images or video, thumbnail, and creation timestamp. `engagement.shares` carries Reddit's share count. `ext.selftext` is null on link posts, which have no body. For the post's comments use `/v1/reddit/post/comments`.

TL;DR: `GET /v1/reddit/post` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `url` | yes | Full URL of the Reddit post |

## Code example

```bash
curl -G "https://www.socialcrawl.dev/v1/reddit/post" \
  --data-urlencode "url=https://www.reddit.com/r/NoteTaking/comments/1o9s55r/i_tried_all_popular_ai_notetaking_apps_so_you/" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I get a Reddit post's body text from an API?

Send a GET request to /v1/reddit/post with the post URL. The response carries the body at ext.selftext, the title at ext.title, and content.text with the two joined, plus score, comment count, author and creation time.

### Do I need a Reddit OAuth app or PRAW?

No. Authentication is your SocialCrawl key in the x-api-key header. There is no Reddit app to register, no client secret to rotate, and the same key works across every other platform in the catalogue.

### Why is ext.selftext null on some posts?

Link posts have no body, so the field is null rather than an empty string. That is the honest value: the post exists and simply carries a URL instead of text. Image and video posts behave the same way.

### What does engagement.shares mean on a Reddit post?

On this endpoint it is Reddit's own share count, a deliberate change from the crosspost figure the field carries elsewhere in the API. The list endpoints leave it null because their source reports a share-button count, which is neither of those two numbers.

### How much does the Reddit Post API cost?

Each post costs 1 credit on the standard tier. New accounts get 100 free credits with no credit card required, which is 100 post reads. Repeats inside the cache window cost 0.

See the full Reddit API: https://www.socialcrawl.dev/platforms/reddit

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How do I get the body text of a Reddit post from its URL?
- Can I fetch a Reddit post without OAuth or a Reddit app?
- What does the SocialCrawl Reddit Post API return?