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

> Returns the full threaded comment tree for a Reddit post. Nested replies are auto-expanded by following upstream pagination, so a single call returns the deep tree (not just top-level comments). Each comment includes the author, body, score, direct-reply count, awards, creation timestamp, and a recursive `replies[]` array. Very large threads are bounded: any branch left unexpanded exposes an `ext.replies_cursor`, and `data.truncated` is true when more remains.

TL;DR: `GET /v1/reddit/post/comments` costs 5 credits 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 to fetch comments for |
| `cursor` | no | Cursor to get more comments, or replies. |
| `trim` | no | Set to true for a trimmed down version of the response |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/reddit/post/comments?url=https%3A%2F%2Fwww.reddit.com%2Fr%2Ftechnology%2Fcomments%2Fabc123%2Fexample_post%2F" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I fetch Reddit comments for a post?

Send a GET request to /v1/reddit/post/comments with the full post URL in the url parameter. SocialCrawl returns a threaded comment tree including author, body text, score, reply count, awards, and creation timestamp for every comment.

### Are replies nested or flat in the response?

Replies are nested. Each comment has a replies array containing its direct children, which in turn contain their own replies. Walk the tree recursively to process the full conversation, or flatten it if you only need a sentiment snapshot.

### How do I load more replies on deep threads?

Usually you don't need to — the endpoint returns the full tree by default, auto-following Reddit's nested reply pages for you. Only on very large threads that hit the expansion limit does the response set data.truncated and include a cursor at each unexpanded branch. Pass that cursor as the cursor parameter to fetch the rest.

### Do you return deleted or removed comments?

Reddit replaces deleted comments with placeholder text and removed comments with moderator notices — SocialCrawl returns them as-is so your pipeline can detect and filter them. The original body text is not recoverable from the public endpoint.

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

Each call is a flat 5 credits on the advanced tier, regardless of thread size. It costs more than a basic read because it returns the entire comment tree in one call, auto-expanding Reddit's nested reply pages for you across multiple upstream fetches. Very large threads stop at a safety limit and hand back a cursor to continue. New accounts get 100 free credits, and trim=true keeps payloads light.

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 to fetch all comments from a Reddit post with an API
- What does the SocialCrawl Reddit Comments API return?