Search posts — Reddit API

Searches public Reddit posts across the platform. Supports relevance, hot, top, new, and comments sorting with optional time windows.

Get free API key View the docs

GET/v1/reddit/search/posts1 credit per request

Example response200OK

{
  "data": {
    "type": "OrderedCollectionPage",
    "totalItems": 8420,
    "itemCount": 25,
    "orderedItems": [
      {
        "type": "Note",
        "name": "OpenAI released GPT-5",
        "likeCount": 12000,
        "published": "2026-05-01T10:00:00.000Z"
      }
    ]
  }
}

Make the request.

One authenticated GET to /v1/reddit/search/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

Find posts mentioning a brand or product across Reddit
Research discussions about any topic site-wide
Lead generation and community prospecting

Full reference for this endpoint

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

const data = await response.json();

Parameters5

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