# Reddit API

Monitor Reddit communities, posts, threads, and public user activity without managing browser sessions.

- Platform ID: `reddit`
- Capabilities: 9
- Execute endpoint: `POST https://data.upscrape.com/execute`



## Capabilities

### [List comments](https://docs.upscrape.com/docs/platforms/reddit/reddit.comments.list)

- Capability ID: `reddit.comments.list`
- Cost: 1 credit per request

List recent public comments from one or more subreddits, newest first, with cursor pagination. May take up to 60 seconds.
### [List post comments](https://docs.upscrape.com/docs/platforms/reddit/reddit.post.comments.list)

- Capability ID: `reddit.post.comments.list`
- Cost: 1 credit per request

Return a bounded sample of public comments from one Reddit thread. No page cursor or full conversation coverage. May take up to 60 seconds.
### [Get post](https://docs.upscrape.com/docs/platforms/reddit/reddit.post.get)

- Capability ID: `reddit.post.get`
- Cost: 1 credit per request

Fetch one public Reddit post by canonical thread URL. May take up to 60 seconds.
### [List posts](https://docs.upscrape.com/docs/platforms/reddit/reddit.posts.list)

- Capability ID: `reddit.posts.list`
- Cost: 1 credit per request

List public posts from one or more subreddits, with new, hot, top, and rising rankings and cursor pagination. May take up to 60 seconds.
### [Search posts](https://docs.upscrape.com/docs/platforms/reddit/reddit.posts.search)

- Capability ID: `reddit.posts.search`
- Cost: 1 credit per request

Search public posts globally or within selected subreddits, with Reddit sort and time filters and cursor pagination. May take up to 60 seconds.
### [Get subreddit](https://docs.upscrape.com/docs/platforms/reddit/reddit.subreddit.get)

- Capability ID: `reddit.subreddit.get`
- Cost: 1 credit per request

Fetch public community metadata, including Reddit's anonymous weekly-visitor estimate when available. May take up to 60 seconds.
### [Search subreddits](https://docs.upscrape.com/docs/platforms/reddit/reddit.subreddit.search)

- Capability ID: `reddit.subreddit.search`
- Cost: 1 credit per request

Search public communities by name or topic and return normalized community cards ordered by Reddit relevance. May take up to 60 seconds.
### [List user comments](https://docs.upscrape.com/docs/platforms/reddit/reddit.user.comments.list)

- Capability ID: `reddit.user.comments.list`
- Cost: 1 credit per request

List comments publicly visible on a Reddit user's comments feed, newest first, with cursor pagination. May take up to 60 seconds.
### [List user posts](https://docs.upscrape.com/docs/platforms/reddit/reddit.user.posts.list)

- Capability ID: `reddit.user.posts.list`
- Cost: 1 credit per request

List posts publicly visible on a Reddit user's submitted feed, newest first, with cursor pagination. May take up to 60 seconds.

## Common uses

- Community and topic monitoring
- Customer and market research
- Public discussion and creator analysis

## Integration contract

All capabilities use the shared `POST /execute` envelope. A `200` response completed inline; a `202` response must be polled through `GET /jobs/{id}`.

See [authentication](https://docs.upscrape.com/docs/api/authentication), [jobs and results](https://docs.upscrape.com/docs/api/jobs), and [errors and retries](https://docs.upscrape.com/docs/api/errors).