# Reddit API

Read-only Reddit data: recent posts and comments from given subreddits or all of Reddit (newest first), subreddit…

- Platform ID: `reddit`
- Capabilities: 6
- Execute endpoint: `POST https://data.upscrape.com/execute`
- OpenAPI: https://upscrape.com/scrapers/reddit/openapi.json

## Capabilities

| Endpoint | Capability ID | Cost | Description |
| --- | --- | --- | --- |
| [List Comments](https://docs.upscrape.com/docs/platforms/reddit/reddit.comments.list) | `reddit.comments.list` | 1 credit per request | Recent comments from one or more subreddits (or all of Reddit), newest first, with a cursor for the next page. |
| [Search Comments](https://docs.upscrape.com/docs/platforms/reddit/reddit.comments.search) | `reddit.comments.search` | 1 credit per request | Search comments by query, newest first, optionally restricted to subreddits, with a cursor for the next page. Approximate; callers re-filter locally. |
| [List Posts](https://docs.upscrape.com/docs/platforms/reddit/reddit.posts.list) | `reddit.posts.list` | 1 credit per request | Recent posts from one or more subreddits (or all of Reddit), newest first, with a cursor for the next page. |
| [Search Posts](https://docs.upscrape.com/docs/platforms/reddit/reddit.posts.search) | `reddit.posts.search` | 1 credit per request | Search posts by query, newest first, optionally restricted to subreddits, with a cursor for the next page. |
| [Get Subreddit](https://docs.upscrape.com/docs/platforms/reddit/reddit.subreddit.get) | `reddit.subreddit.get` | 1 credit per request | Fetch a single subreddit's public metadata by name. |
| [Search Subreddits](https://docs.upscrape.com/docs/platforms/reddit/reddit.subreddit.search) | `reddit.subreddit.search` | 1 credit per request | Search communities by name or topic (typeahead-friendly), ordered by relevance, with subscribers and description. |


## 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).