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

# Reddit

> Read posts, comments, subreddits, and users on Reddit via Nephia.

Reddit endpoints live under `/v1/reddit/*`. See the [API Reference](/api-reference/overview) for the full endpoint list. Credit rates are in [Credits](/credits#reddit).

## Pagination

Search, listings, trending, duplicates, and user activity endpoints use an opaque `nextCursor`. Pass it back unchanged on the next request.

Internal page size is capped (\~25 default, \~100 max). Search results are capped at roughly 250 items per query; listings at roughly 1000.

## NSFW content

NSFW posts are **included by default** on all content listings and watches. Pass `include_nsfw=false` to opt out. The `isNsfw` field is always present on post objects.

When creating a watch, omit `include_nsfw` or set it to `true` to include NSFW matches. Set `include_nsfw: false` to filter them out.

## Search operators

Post search (`GET /v1/reddit/search/posts`) supports Reddit-style query syntax in the `q` parameter — for example `title:keyword`, `author:username`, `flair:text`, `self:yes`, `url:domain.com`. Scope to a subreddit with the `subreddit` query param.

Subreddit and user search return lean hit objects; full profiles are on the about routes (`/subreddits/:name`, `/users/:username`). Popular and new subreddit listings (`/subreddits/popular`, `/subreddits/new`) also return lean hits.

## Domain posts

`GET /v1/reddit/domains/:domain/posts` lists posts linking to a domain. The `domain` param accepts bare hostnames or URLs (protocol is stripped). Default sort is `new`; optional `sort` and `t` match subreddit listings.

## Wiki

Page content (`GET /v1/reddit/subreddits/:name/wiki/:page`) returns markdown and HTML plus revision metadata.

## User extras

`GET /v1/reddit/users/:username/moderated` lists moderated subreddits. `GET /v1/reddit/users/:username/trophies` returns trophy awards.

## Post detail vs comments

`GET /v1/reddit/posts/:id` returns the post only. The comment tree is on `GET /v1/reddit/posts/:id/comments`.

Comment responses are nested (`replies[]`). Use `sort` (`confidence`, `top`, `new`, `controversial`, `old`, `qa`, `live`), `depth` (0–10), and `cursor` to paginate through `morechildren` batches. Billing is variable — see [Credits](/credits#reddit). Each response includes `meta.credits_used`.

## Soft 404 (definitive, still billed)

| Code                  | HTTP | When                     |
| --------------------- | ---- | ------------------------ |
| `POST_NOT_FOUND`      | 404  | Post id does not exist   |
| `POST_REMOVED`        | 404  | Post was removed         |
| `SUBREDDIT_NOT_FOUND` | 404  | Subreddit does not exist |
| `SUBREDDIT_PRIVATE`   | 404  | Subreddit is private     |
| `USER_NOT_FOUND`      | 404  | User does not exist      |
| `USER_SUSPENDED`      | 404  | User is suspended        |

Credits are charged for these definitive 404s on the relevant endpoint.

## Post ids

`:id` accepts bare base36 ids or fullnames (`t3_…`). Responses always normalize to bare `id` plus `fullname`.

## Watches

Reddit watches poll post search or subreddit listings and deliver `post.created` webhooks with the full enriched post shape. See [Watches](/watches) and [Webhooks](/webhooks).