Public Reddit profiles, posts, comments, search, subreddits, and wikis.
Reddit provides 20 read endpoints in Test and Live environments.
Use your Openhandle key with the standard Authorization: Bearer header.
Endpoints
| Operation | Endpoint |
|---|---|
| Get 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 profile moderated | GET /v1/reddit/profiles/{identifier}/moderated |
| List profile trophies | GET /v1/reddit/profiles/{identifier}/trophies |
| Get post | GET /v1/reddit/posts/{identifier} |
| List post comments | GET /v1/reddit/posts/{identifier}/comments |
| List post duplicates | GET /v1/reddit/posts/{identifier}/duplicates |
| List trending posts | GET /v1/reddit/trending/posts |
| List search posts | GET /v1/reddit/search/posts?q={query} |
| List search profiles | GET /v1/reddit/search/profiles?q={query} |
| List search subreddits | GET /v1/reddit/search/subreddits?q={query} |
| List domain posts | GET /v1/reddit/domains/{identifier}/posts |
| Get 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 wiki page | GET /v1/reddit/subreddits/{identifier}/wiki-pages/{page} |
| List subreddits popular | GET /v1/reddit/subreddits/popular |
| List subreddits new | GET /v1/reddit/subreddits/new |
Identifiers and filters
Profile paths accept @username or a profile ID such as t2_1w72.
A profile ID resolves only after that profile was fetched by username once.
Post paths accept a Reddit post ID, such as 1w78kp5.
Subreddit paths accept the community name without r/.
Domain paths accept a hostname, such as github.com.
Wiki paths use the page name, such as index.
Listings accept limit from 1 to 100 where documented in OpenAPI.
Feed and search endpoints support their documented sort options.
Use t=hour|day|week|month|year|all to select a supported time filter.
Search posts can also use subreddit to restrict results to one community.
Pagination and comment trees
Pass meta.cursors.next as cursor to fetch the next page.
Keep the identifier, search query, filters, and freshness unchanged.
A null next cursor ends the collection.
Post comments return nested replies arrays.
Use depth=0 through depth=10 to control the tree depth.
The comments endpoint returns a bounded tree without a continuation cursor.
Rules, trophies, moderated communities, and wiki indexes return complete collections without continuation cursors.
Response fields
Reddit has dedicated profile, post, comment, subreddit, rule, wiki, and trophy schemas. Karma does not become follower counts. Post and comment scores can be negative. Missing optional metrics remain null. Media fields use managed Openhandle URLs. Post links and wiki text retain their public content URLs.
Test data
Use /v1/test-data?platform=reddit to find deterministic examples.
Test keys never contact the upstream provider.