KonbiniAPI

The Reddit API for products and pipelines.

Retrieve supported public Reddit data — users, subreddits, posts, comment trees, global feeds, search, and batch reads — through REST endpoints that return one consistent response model.

Get free API keyView the docs
  • 22 supported endpoints
  • Public data only
  • Fetched at request time
GET/v1/reddit/subreddits/{subreddit}/posts200OK
{
  "type": "OrderedCollectionPage",
  "itemCount": 3,
  "nextCursor": "t3_1vd1sxs",
  "orderedItems": [
    {
      "name": "My best view of the Milky Way from ISS",
      "published": "2026-08-02T15:32:12.000Z",
      "voteCount": 27920,
      "commentCount": 242
    }
  ]
}

What you can pull from Reddit.

Reddit is the platform where ordering matters, and the endpoints expose it directly. User posts, user comments, subreddit posts, and subreddit comments all take hot, new, top, rising, or controversial, and the two ranked orders take a time window. That is what makes Reddit usable as a recurring source: the same call, ordered the same way, run on a schedule.

It is also the only platform here with batch reads. Posts, comments, and subreddits each accept up to 100 ids in one request, which turns a list of ids from a search or a stored dataset into a single call. Batch reads bill per id — 100 ids costs 100 credits, exactly what fetching them one at a time would cost — so the saving is round trips, not spend.

Every response uses the same ActivityStreams 2.0-based model as the other supported platforms, so a Reddit integration reuses the parsing you already wrote. Fields specific to Reddit stay as documented first-class fields rather than being flattened away.

Reddit data
  • User profiles, posts, comments, and mixed overviews
  • Subreddit metadata, rules, and sticky posts
  • Posts, comment trees, and reply chains
  • Crossposts and duplicate submissions
  • Global feeds and platform-wide search
  • Batch reads of up to 100 ids

All 22 Reddit endpoints.

Grouped by what they return. Every one has its parameter contract, a request you can copy, and an example response.

Profiles

4

The account or community record, a subreddit’s posting rules, and a batch read for up to 100 subreddits at once.

Get user profileReturns public Reddit user profile information including bio, avatar, verification flags, and account creation date.GET /v1/reddit/users/{username}Get subredditReddit API: Returns public subreddit metadata including title, description, icon, banner, and subscriber count.GET /v1/reddit/subreddits/{subreddit}Get subreddit rulesFetch Reddit community rules as structured data for moderation, policy checks, and community management workflows.GET /v1/reddit/subreddits/{subreddit}/rulesGet subreddits in batchFetch up to 100 Reddit communities by ID in one request for bulk enrichment and audience research workflows.POST /v1/reddit/subreddits/batch

Feeds

4

Ordered listings — hot, new, top, rising, controversial — plus a user’s mixed overview and a subreddit’s stickied posts.

Get user postsReturns public posts submitted by a Reddit user. Supports hot, new, top, and controversial ordering, with optional time windows for top and controversial.GET /v1/reddit/users/{username}/postsGet user overviewReturns a mixed Reddit user activity feed including posts and comments. Supports hot, new, top, and controversial ordering, with optional time windows for…GET /v1/reddit/users/{username}/overviewGet subreddit postsReddit API: Returns public posts from a subreddit. Supports hot, new, top, rising, and controversial ordering, with optional time windows for top and…GET /v1/reddit/subreddits/{subreddit}/postsGet subreddit sticky postsFetch pinned posts from a Reddit community as structured data for announcement tracking and moderation workflows.GET /v1/reddit/subreddits/{subreddit}/sticky

Posts

2

One post by id, or up to 100 of them in a single request.

Get postFetch a public Reddit post with its title, body, author, engagement, and attachments for research or archiving.GET /v1/reddit/posts/{postId}Get posts in batchFetch up to 100 Reddit posts by ID in one request for bulk content analysis and enrichment pipelines.POST /v1/reddit/posts/batch

Comments

6

The widest comment surface here: by user, by subreddit, by post, one at a time, down a reply chain, or 100 ids at once.

Get user commentsReturns public comments made by a Reddit user. Supports hot, new, top, and controversial ordering, with optional time windows for top and controversial.GET /v1/reddit/users/{username}/commentsGet subreddit commentsReddit API: Returns public comments from a subreddit. Supports hot, new, top, and controversial ordering, with optional time windows for top and…GET /v1/reddit/subreddits/{subreddit}/commentsGet post commentsReturns top-level comments on a Reddit post. Supports Reddit comment ordering and cursor-based pagination.GET /v1/reddit/posts/{postId}/commentsGet commentFetch a public Reddit comment with author, scores, replies, and available media for moderation or research.GET /v1/reddit/posts/{postId}/comments/{commentId}Get comment repliesFetch direct replies to a Reddit comment with cursor pagination for complete threaded discussion analysis.GET /v1/reddit/posts/{postId}/comments/{commentId}/repliesGet comments in batchFetch up to 100 Reddit comments by ID in one request for bulk discussion analysis and moderation workflows.POST /v1/reddit/comments/batch

Discovery

6

Platform-wide and in-subreddit search, the global feed, and the crossposts that duplicate a submission.

Search subreddit postsSearches public Reddit posts within a subreddit. Supports relevance, hot, top, new, and comments sorting with optional time windows.GET /v1/reddit/subreddits/{subreddit}/searchGet duplicate postsFind duplicate submissions and crossposts for a Reddit post to trace how content spreads across communities.GET /v1/reddit/posts/{postId}/duplicatesGet feedFetch posts from a top-level Reddit feed such as best, hot, new, top, rising, or controversial for trend monitoring and content discovery.GET /v1/reddit/feeds/{feed}Search postsSearches public Reddit posts across the platform. Supports relevance, hot, top, new, and comments sorting with optional time windows.GET /v1/reddit/search/postsSearch usersSearch public Reddit users by keyword and return matching profiles for discovery and community research workflows.GET /v1/reddit/search/usersSearch subredditsSearch public Reddit communities by keyword and return matching subreddits for audience and topic research.GET /v1/reddit/search/subreddits

How the calls fit together.

Few Reddit jobs are a single request. Most are two or three chained, each call keyed by an id the one before it returned.

Monitor a community

Read the subreddit for context, page its posts on a fixed order, then open the comment tree on whatever moved.

  1. 1Get subreddit/v1/reddit/subreddits/{subreddit}
  2. 2Get subreddit posts/v1/reddit/subreddits/{subreddit}/posts
  3. 3Get post comments/v1/reddit/posts/{postId}/comments

Keep a dataset current

Search once for the posts worth tracking, then re-read up to 100 stored ids in a single call whenever the numbers need refreshing.

  1. 1Search posts/v1/reddit/search/posts
  2. 2Get posts in batch/v1/reddit/posts/batch

Profile an account

Read the user, then their mixed activity feed for posts and comments in one ordered stream.

  1. 1Get user profile/v1/reddit/users/{username}
  2. 2Get user overview/v1/reddit/users/{username}/overview

What shapes your Reddit integration.

Page sizes, ordering, and what the platform itself withholds — the details that decide how you build, settled before you write a line of code.

01Batch reads take up to 100 ids and bill per id
The posts, comments, and subreddits batch endpoints accept 1–100 ids in a POST body and cost 1 credit per id submitted. They save round trips, not credits.
02Ordering is part of the request
Post and comment listings take hot, new, top, or controversial — subreddit posts also take rising — and the ranked orders accept a time window. Two runs with different orders are two different datasets.
03Comment trees are walked, not returned whole
The post comments endpoint returns top-level comments with cursor pagination. Replies to a specific comment come from the replies endpoint, so depth is a decision the caller makes per branch.
04Search is scoped or platform-wide
Posts, users, and subreddits can be searched across the platform, and posts can also be searched inside one subreddit. Both take relevance, hot, top, new, or comments sorting with optional time windows.
Read the Reddit referenceMake your first request

Other platforms

Build on Reddit data.

Get a free API key and call any of these endpoints in minutes. No credit card required.

Get free API keyReddit reference