Skip to main content
GET
/
v1
/
reddit
/
subreddits
/
{subreddit}
/
search
Search subreddit posts
curl --request GET \
  --url https://api.konbiniapi.com/v1/reddit/subreddits/{subreddit}/search \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "@context": [
      "https://www.w3.org/ns/activitystreams#",
      "https://konbiniapi.com/ns/social#"
    ],
    "type": "OrderedCollectionPage",
    "partOf": "https://api.konbiniapi.com/v1/reddit/subreddits/programming/search?q=openai",
    "totalItems": 1309,
    "cursor": "0",
    "nextCursor": "1772217402000",
    "next": "https://api.konbiniapi.com/v1/reddit/subreddits/programming/search?q=openai&cursor=t3_post_2&count=25&order=top&time=week",
    "itemCount": 30,
    "orderedItems": [
      {
        "id": "https://www.reddit.com/r/programming/comments/post_1/launch_day/",
        "url": "https://www.reddit.com/r/programming/comments/post_1/launch_day/",
        "content": "We shipped Reddit support.",
        "likeCount": 93210,
        "entityId": "post_1",
        "name": "Launch day",
        "published": "2026-02-27T20:37:38.000Z",
        "isEdited": false,
        "isLocked": false,
        "isOriginal": false,
        "isPinned": false,
        "isSponsored": false,
        "isAdult": false,
        "isSpoiler": false,
        "isSearchable": true,
        "voteCount": 118,
        "commentCount": 15,
        "shareCount": 8,
        "attributedTo": {
          "id": "https://www.reddit.com/user/spez/",
          "url": "https://www.reddit.com/user/spez/",
          "entityId": "t2_4x25quk",
          "preferredUsername": "spez",
          "name": "Steve Huffman",
          "icon": {
            "type": "Image",
            "url": "https://i.redd.it/post1.png",
            "width": 1200,
            "height": 675
          },
          "role": "admin",
          "summary": "Reddit CEO",
          "published": "2005-12-08T07:46:43.000Z",
          "isVerified": true,
          "isEmployee": true,
          "isMod": false,
          "isPremium": false,
          "isSearchable": true,
          "isFollowable": true,
          "isAdult": false,
          "score": 999999,
          "postScore": 555555,
          "commentScore": 444444,
          "awarderScore": 123,
          "awardeeScore": 321,
          "status": "active",
          "image": {
            "type": "Image",
            "url": "https://i.redd.it/post1.png",
            "width": 1200,
            "height": 675
          }
        },
        "icon": {
          "type": "Image",
          "url": "https://i.redd.it/post1.png",
          "width": 1200,
          "height": 675
        },
        "image": [
          {
            "type": "Image",
            "url": "https://i.redd.it/post1.png",
            "width": 1200,
            "height": 675
          }
        ],
        "attachment": [
          {
            "type": "Image",
            "url": "https://i.redd.it/post1.png",
            "width": 1200,
            "height": 675
          }
        ],
        "tag": [
          {
            "type": "Tag",
            "name": "programming",
            "href": "https://www.reddit.com/r/programming/"
          }
        ],
        "quote": {
          "id": "https://www.reddit.com/r/programming/comments/post_1/launch_day/",
          "url": "https://www.reddit.com/r/programming/comments/post_1/launch_day/",
          "content": "We shipped Reddit support.",
          "likeCount": 93210,
          "entityId": "post_1",
          "name": "Launch day",
          "published": "2026-02-27T20:37:38.000Z",
          "isEdited": false,
          "isLocked": false,
          "isOriginal": false,
          "isPinned": false,
          "isSponsored": false,
          "isAdult": false,
          "isSpoiler": false,
          "isSearchable": true,
          "voteCount": 118,
          "commentCount": 15,
          "shareCount": 8,
          "attributedTo": {
            "id": "https://www.reddit.com/user/spez/",
            "url": "https://www.reddit.com/user/spez/",
            "entityId": "t2_4x25quk",
            "preferredUsername": "spez",
            "name": "Steve Huffman",
            "icon": {
              "type": "Image",
              "url": "https://i.redd.it/post1.png",
              "width": 1200,
              "height": 675
            },
            "role": "admin",
            "summary": "Reddit CEO",
            "published": "2005-12-08T07:46:43.000Z",
            "isVerified": true,
            "isEmployee": true,
            "isMod": false,
            "isPremium": false,
            "isSearchable": true,
            "isFollowable": true,
            "isAdult": false,
            "score": 999999,
            "postScore": 555555,
            "commentScore": 444444,
            "awarderScore": 123,
            "awardeeScore": 321,
            "status": "active",
            "image": {
              "type": "Image",
              "url": "https://i.redd.it/post1.png",
              "width": 1200,
              "height": 675
            }
          },
          "icon": {
            "type": "Image",
            "url": "https://i.redd.it/post1.png",
            "width": 1200,
            "height": 675
          },
          "image": [
            {
              "type": "Image",
              "url": "https://i.redd.it/post1.png",
              "width": 1200,
              "height": 675
            }
          ],
          "attachment": [
            {
              "type": "Image",
              "url": "https://i.redd.it/post1.png",
              "width": 1200,
              "height": 675
            }
          ],
          "tag": [
            {
              "type": "Tag",
              "name": "programming",
              "href": "https://www.reddit.com/r/programming/"
            }
          ]
        }
      }
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.konbiniapi.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Send your API key in the Authorization header as a Bearer token. Example: Authorization: Bearer <your-api-key>

Path Parameters

​
subreddit
string
required

Subreddit name (with or without r/ prefix)

Example:

"programming"

Query Parameters

​
q
string
required

Search query

Minimum string length: 1
Example:

"askreddit"

​
count
integer
default:25

Number of posts to fetch (maximum: 100)

Required range: 1 <= x <= 100
Example:

25

​
cursor
string

Pagination cursor

Example:

"0"

​
order
enum<string>
default:relevance

Sort order: relevance (default), hot, top, new, or comments

Available options:
relevance,
hot,
top,
new,
comments
Example:

"relevance"

​
time
enum<string>

Optional time window for search results: hour, day, week, month, year, or all

Available options:
hour,
day,
week,
month,
year,
all
Example:

"week"

Response

Returns subreddit search results

​
data
object
required