Skip to main content
GET
/
v1
/
reddit
/
search
/
subreddits
Search subreddits
curl --request GET \
  --url https://api.konbiniapi.com/v1/reddit/search/subreddits \
  --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/search/subreddits?q=programming",
    "totalItems": 1309,
    "cursor": "0",
    "nextCursor": "1772217402000",
    "next": "https://api.konbiniapi.com/v1/reddit/search/subreddits?q=programming&cursor=t5_subreddit_2&count=25",
    "itemCount": 30,
    "orderedItems": [
      {
        "id": "https://www.reddit.com/r/programming/",
        "url": "https://www.reddit.com/r/programming/",
        "name": "programming",
        "entityId": "2fwo",
        "slug": "programming",
        "summary": "Subreddit dedicated to the news and discussions about the creation and use of technology and its surrounding issues.",
        "description": "/r/technology is a place to share and discuss the latest developments, happenings and curiosities in the world of technology.",
        "guidelines": "Please read the /r/technology sidebar for a list of our rules and guidelines.",
        "published": "2008-01-24T17:36:07.000Z",
        "isAdult": false,
        "isSearchable": true,
        "category": "Technology",
        "memberCount": 5000000,
        "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
        }
      }
    ]
  }
}

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>

Query Parameters

q
string
required

Search query

Minimum string length: 1
Example:

"askreddit"

count
integer
default:25

Number of subreddits to fetch (maximum: 100)

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

25

cursor
string

Pagination cursor

Example:

"0"

Response

Returns matching subreddits

data
object
required