docs / reddit

Posts, comments, subreddits and search.

base /reddit/v16 endpoints

post/reddit/v1/subreddit_posts1 credit

Posts in a subreddit, ranked by `sort`. Returns title/author/score/comment-count.

Parameter		Allowed / range	Description
subreddit	required	—	Subreddit name (without 'r/').
sort = hot	optional	hot · new · top · rising · controversial	How posts are ranked.
time = day	optional	hour · day · week · month · year · all	Time window — applies ONLY when sort = top or controversial.
limit = 10	optional	1–100	How many posts to return (1–100).
source = auto	optional	auto · live · arctic · pullpush	Which Reddit data source to use — 'auto' picks the best source automatically.
page = 1	optional	1–	Page number (easy paging: 1, 2, 3…).
cursor	optional	—	Next page: pass the previous response's meta.pagination.next_cursor (the 'Next' button does this automatically).

Try in playground →

post/reddit/v1/post_comments1 credit

Threaded comments for a post. Returns author/body/score per comment.

Parameter		Allowed / range	Description
post_id	required	—	Post ID or full Reddit URL.
sort = top	optional	top · new · controversial · old · qa	Comment ordering.
limit = 50	optional	1–500	How many comments (1–500).
depth = 10	optional	1–50	Comment-tree depth (1–50).
source = auto	optional	auto · live · arctic · pullpush	Which Reddit data source to use — 'auto' picks the best source automatically.

Try in playground →

post/reddit/v1/search1 credit

Search posts or comments by `q` and/or `subreddit`/`author`. Returns results[].

Parameter		Allowed / range	Description
q	optional	—	Search text. Provide `q` and/or `subreddit`/`author`.
subreddit	optional	—	Limit the search to one subreddit (optional).
author	optional	—	Limit to one author's content (optional).
type = post	optional	post · comment	Search posts or comments.
sort = relevance	optional	relevance · new · top · comments	Result ordering.
limit = 10	optional	1–100	How many results (1–100).
after_utc	optional	—	Only results AFTER this unix time (optional).
before_utc	optional	—	Only results BEFORE this unix time (optional).
source = auto	optional	auto · live · arctic · pullpush	Which Reddit data source to use — 'auto' picks the best source automatically.
page = 1	optional	1–	Page number (easy paging: 1, 2, 3…).
cursor	optional	—	Next page: pass the previous response's meta.pagination.next_cursor (the 'Next' button does this automatically).

Try in playground →

post/reddit/v1/user1 credit

User profile or content. kind=about returns karma/profile; submitted/comments list items.

Parameter		Allowed / range	Description
username	required	—	Reddit username (without 'u/').
kind = about	optional	about · submitted · comments	What to return.
limit = 25	optional	1–100	How many items (for submitted/comments, 1–100).
sort = new	optional	new · top · hot	Ordering (for submitted/comments).
source = auto	optional	auto · live · arctic · pullpush	Which Reddit data source to use — 'auto' picks the best source automatically.
cursor	optional	—	Next page: pass the previous response's meta.pagination.next_cursor (the 'Next' button does this automatically).

Try in playground →

post/reddit/v1/subreddit_about1 credit

Subreddit metadata: subscribers, description, created date, etc.

Parameter		Allowed / range	Description
subreddit	required	—	Subreddit name (without 'r/').
source = auto	optional	auto · live · arctic · pullpush	Which Reddit data source to use — 'auto' picks the best source automatically.

Try in playground →

post/reddit/v1/communities1 credit

Search subreddits by name/keyword — find communities matching a term, with each one's subscribers, title, description and over-18 flag.

Parameter		Allowed / range	Description
q	required	—	Name or keyword to search subreddits for.
limit = 25	optional	1–100	Max communities to return (1–100).

Try in playground →

Example request · subreddit_posts

curl -X POST https://api.reefapi.com/reddit/v1/subreddit_posts \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"subreddit":"python","limit":10}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}

Reddit