Platform API Social & content

Reddit API

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

Platform ID reddit

Endpoints 6 capabilities

Status 97.4% success rate

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

Capabilities

Every capability uses the same POST /execute envelope. Open an endpoint for its exact ID, input contract, code samples, cost, runtime, and illustrative output.

Endpoint Description Cost

List Comments reddit.comments.list

Recent comments from one or more subreddits (or all of Reddit), newest first, with a cursor for the next page.

1 credit per request

Search Comments reddit.comments.search

Search comments by query, newest first, optionally restricted to subreddits, with a cursor for the next page. Approximate; callers re-filter locally.

1 credit per request

List Posts reddit.posts.list

Recent posts from one or more subreddits (or all of Reddit), newest first, with a cursor for the next page.

1 credit per request

Search Posts reddit.posts.search

Search posts by query, newest first, optionally restricted to subreddits, with a cursor for the next page.

1 credit per request

Get Subreddit reddit.subreddit.get

Fetch a single subreddit's public metadata by name.

1 credit per request

Search Subreddits reddit.subreddit.search

Search communities by name or topic (typeahead-friendly), ordered by relevance, with subscribers and description.

1 credit per request

Integration contract

A 200 response completed inline. A 202 response was queued; poll GET /jobs/:id until it reaches completed or failed.