Search subreddit posts — Reddit API

Searches public Reddit posts within a subreddit. Supports relevance, hot, top, new, and comments sorting with optional time windows.

Get free API key View the docs

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

Example response200OK

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

Make the request.

One authenticated GET to /v1/reddit/subreddits/{subreddit}/search. 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

Find posts about a specific topic within a community
Brand mention monitoring inside niche subreddits
Content research for competitive analysis

Full reference for this endpoint

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

const data = await response.json();

Parameters6

subredditrequiredIn · PathType · stringSubreddit name (with or without `r/` prefix)
qrequiredIn · QueryType · stringSearch query
countIn · QueryType · integerNumber of posts to fetch (maximum: 100)1–100default 25
cursorIn · QueryType · stringPagination cursor
orderIn · QueryType · stringSort order: relevance (default), hot, top, new, or commentsrelevance | hot | top | new | commentsdefault relevance
timeIn · QueryType · stringOptional time window for search results: hour, day, week, month, year, or allhour | 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