Reddit API · ReefAPI

docs / reddit

Posts, comments, subreddits and search.

base /reddit/v15 endpoints

post/reddit/v1/subreddit_posts1 credit

posts in a subreddit by `sort` (hot/new/top/rising/controversial) → posts[]{title,author,score,...}. `subreddit` required. live ranking via Reddit, or source=arctic for a fresh archive listing. params: sort, time, limit(<=100), after, source.

Parameter	Required
subreddit	optional
sub	optional
sort	optional
time	optional
limit	optional
after	optional
source	optional

Try in playground →

post/reddit/v1/post_comments1 credit

threaded comments for a post (`post_id`|`id`|`url` required) → comments[]{author,body,score,...}. params: sort, limit(<=500), depth(<=50), source.

Parameter	Required
post_id	optional
id	optional
url	optional
sort	optional
limit	optional
depth	optional
source	optional

Try in playground →

post/reddit/v1/search1 credit

search posts/comments by `q` and/or `subreddit`/`author` → results[]. type=post|comment. Routes to arctic/pullpush (archive) or live by scope. params: q, subreddit, author, type, sort, limit, after_utc, before_utc, source.

Parameter	Required
q	optional
query	optional
subreddit	optional
sub	optional
author	optional
type	optional
sort	optional
limit	optional
after_utc	optional
before_utc	optional
source	optional

Try in playground →

post/reddit/v1/user1 credit

user profile (`username`|`user` required): kind=about (live karma/profile) | submitted | comments. params: kind, limit, after, sort, source.

Parameter	Required
username	optional
user	optional
name	optional
kind	optional
limit	optional
after	optional
sort	optional
source	optional

Try in playground →

post/reddit/v1/subreddit_about1 credit

subreddit metadata (`subreddit` required): subscribers/description/created/... (live or source=arctic).

Parameter	Required
subreddit	optional
sub	optional
source	optional

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
}