> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spidra.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Reddit

> Get subreddit posts, posts with their comments, user activity and Reddit search results as structured data, for 1 credit per link.

Send a Reddit link to [Scrape](https://docs.spidra.io/scrape.md) or [Batch scrape](https://docs.spidra.io/batch-scrape.md) and you get the data Reddit shows signed-out visitors, as JSON: a subreddit's posts, a post with its comments, a user's activity, or search results. Each link costs 1 credit, and links that can't be read cost nothing.

## Example

```json theme={null}
{ "urls": ["https://www.reddit.com/r/espresso/"], "output": "json", "wait": true }
```

The item's `result`, shortened to one post:

```json theme={null}
{
  "type": "subreddit",
  "subreddit": "espresso",
  "sort": "best",
  "postCount": 27,
  "posts": [
    {
      "title": "My barista heart hurts :(",
      "author": "...",
      "score": 563,
      "comments": 129,
      "postType": "image",
      "createdAt": "2026-10-24T17:53:04.182Z",
      "url": "https://www.reddit.com/r/espresso/comments/1xef55g/my_barista_heart_hurts/"
    }
  ],
  "nextCursor": "dDNfMXhia2k3bw"
}
```

Add `?after=<nextCursor>` to the subreddit link for the next page.

## Links that work

| Link | Example | You get |
| - | - | - |
| Subreddit | `reddit.com/r/<name>/`, with a sort (`/new`, `/top`) and `?t=` | About 25 to 30 posts |
| Post | `reddit.com/r/<name>/comments/<id>/`, `/comments/<id>/`, `redd.it/...` | The post, its text and images, and the comments Reddit loads with it |
| User | `reddit.com/user/<name>/` | The posts and comments on the profile |
| Search | `reddit.com/search/?q=...`, `reddit.com/r/<name>/search/?q=...` | About 28 matching posts |

## Fields

**Post in a list:** `id`, `title`, `author`, `subreddit`, `score`, `upvoteRatio`, `upvotePercent`, `comments`, `awards`, `postType`, `createdAt`, `linkUrl`, `domain`, `language`, `nsfw`, `spoiler`, `text` and `url`.

**Single post:** the same, plus `textMarkdown`, `images`, `commentCount` and `commentTree` (each comment with author, score, depth, date and text). A post removed by moderators or deleted still returns its author, score and comments, with `removed` and `removedNotice`; its title and text are gone.

## Limits

Saved, upvoted and other signed-in pages fail straight away and cost nothing, and so does an empty profile. Your cookies are never sent to Reddit.

## Templates

Ready-made [templates](https://docs.spidra.io/templates.md) for Reddit: subreddit posts, post details, post comments, user activity and search.

> [!NOTE]
>
> Check Reddit's terms before you collect data from it. You're responsible for how you use what you collect.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.