Get subreddit posts — Reddit API

Returns public posts from a subreddit. Supports hot, new, top, rising, and controversial ordering, with optional time windows for top and controversial.

Get free API key View the docs

GET/v1/reddit/subreddits/{subreddit}/posts1 credit per request

Example response200OK

{
  "data": {
    "type": "OrderedCollectionPage",
    "itemCount": 25,
    "orderedItems": [
      {
        "type": "Note",
        "name": "Launch day",
        "likeCount": 93210,
        "commentCount": 15,
        "published": "2026-02-27T20:37:38.000Z"
      }
    ]
  }
}

Make the request.

One authenticated GET to /v1/reddit/subreddits/{subreddit}/posts. Authentication and error conventions stay consistent across endpoints. This page shows the path, parameters, response shape, limits, and credit rule for this operation.

Built for

Monitor trending content in a community
Content aggregation and newsletter curation
Competitive intelligence from niche communities

Full reference for this endpoint

const response = await fetch("https://api.konbiniapi.com/v1/reddit/subreddits/programming/posts", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});

const data = await response.json();

Parameters5

subredditrequiredIn · PathType · stringSubreddit name (with or without `r/` prefix)
countIn · QueryType · integerNumber of posts to fetch (maximum: 100)1–100default 25
cursorIn · QueryType · stringPagination cursor
orderIn · QueryType · stringSort order: hot (default), new, top, rising, or controversialhot | new | top | rising | controversialdefault hot
timeIn · QueryType · stringTime window for top or controversial ordering: hour, day, week, month, year, or all (default)hour | day | week | month | year | all

What you will probably call next.

The Reddit endpoints around this one — the same object at a different depth, or the same kind of read.

All Reddit endpoints Browse every platform

Try it on your own data.

Get a free API key and make this request in minutes. Failed and timed-out requests are automatically refunded.

Get free API key Endpoint reference