# Reddit API

Read public Reddit data through 20 typed endpoints with shared authentication, caching, and usage tracking.

Status: Beta access in Test and Live environments. Last reviewed September 5, 2026.
Example: GET https://api.openhandle.dev/v1/reddit/profiles/@{username}
Every call is one request at the same price. All endpoints accept the freshness parameter.

## Endpoints (20 operations)

| Operation | Endpoint |
|---|---|
| Get a profile | GET /v1/reddit/profiles/{identifier} |
| List profile posts | GET /v1/reddit/profiles/{identifier}/posts |
| List profile comments | GET /v1/reddit/profiles/{identifier}/comments |
| List moderated subreddits | GET /v1/reddit/profiles/{identifier}/moderated |
| List profile trophies | GET /v1/reddit/profiles/{identifier}/trophies |
| Get a post | GET /v1/reddit/posts/{identifier} |
| List post comments | GET /v1/reddit/posts/{identifier}/comments |
| List duplicate posts | GET /v1/reddit/posts/{identifier}/duplicates |
| List trending posts | GET /v1/reddit/trending/posts |
| Search posts | GET /v1/reddit/search/posts?q={query} |
| Search profiles | GET /v1/reddit/search/profiles?q={query} |
| Search subreddits | GET /v1/reddit/search/subreddits?q={query} |
| List domain posts | GET /v1/reddit/domains/{identifier}/posts |
| Get a subreddit | GET /v1/reddit/subreddits/{identifier} |
| List subreddit posts | GET /v1/reddit/subreddits/{identifier}/posts |
| List subreddit rules | GET /v1/reddit/subreddits/{identifier}/rules |
| List wiki pages | GET /v1/reddit/subreddits/{identifier}/wiki-pages |
| Get a wiki page | GET /v1/reddit/subreddits/{identifier}/wiki-pages/{page} |
| List popular subreddits | GET /v1/reddit/subreddits/popular |
| List new subreddits | GET /v1/reddit/subreddits/new |

Post comments return a nested tree. Use depth to control reply levels.

Field reference: https://openhandle.dev/docs/platforms/reddit.md (generated from the API, the source of truth for fields and types).

## Limitations

- Public content only.
- Profile ID lookups work only for profiles fetched by username before.
- Comment trees support a maximum depth of 10 and do not expose a continuation cursor.

## FAQ

### Can I test without calling Reddit?

Yes. Test keys use deterministic synthetic responses.

### Does karma mean followers?

No. Responses keep karma, subscriber counts, and scores separate.

Docs: https://openhandle.dev/docs/platforms/reddit · Pricing: https://openhandle.dev/pricing.md