Skip to main content

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.

​
What it does

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

​
Tool details

FieldValue
Tool namereddit_search_subreddit_posts
PlatformReddit
REST endpointGET /v1/reddit/subreddits/{subreddit}/search
Result typeCollection tool

​
Parameters

ParameterTypeRequiredDescription
subredditstringYesSubreddit name (with or without r/ prefix)
qstringYesSearch query
countintegerNoNumber of posts to fetch (maximum: 100) Default: 25.
cursorstringNoPagination cursor
orderstringNoSort order: relevance (default), hot, top, new, or comments Default: relevance. Allowed values: relevance, hot, top, new, comments.
timestringNoOptional time window for search results: hour, day, week, month, year, or all Allowed values: hour, day, week, month, year, all.
projection_presetstringNoDefaults to minimal. Allowed values: full, minimal, identity, engagement, content.
data_fieldsstring[]NoAdds top-level keys from data on top of the selected projection_preset.
item_fieldsstring[]NoAdds keys from data.orderedItems[] on top of the selected projection_preset.

​
Example

{
  "name": "reddit_search_subreddit_posts",
  "arguments": {
    "subreddit": "programming",
    "q": "<q>",
    "count": 25,
    "projection_preset": "minimal",
    "data_fields": [
      "orderedItems",
      "nextCursor",
      "cursor",
      "itemCount"
    ],
    "item_fields": [
      "entityId",
      "name",
      "published",
      "content",
      "url"
    ]
  }
}

​
Available data fields

  • @context
  • type
  • partOf
  • totalItems
  • cursor
  • nextCursor
  • next
  • itemCount
  • orderedItems

​
Available item fields

  • type
  • id
  • url
  • entityId
  • name
  • content
  • published
  • isEdited
  • isLocked
  • isOriginal
  • isPinned
  • isSponsored
  • isAdult
  • isSpoiler
  • isSearchable
  • likeCount
  • voteCount
  • commentCount
  • shareCount
  • attributedTo
  • icon
  • image
  • attachment
  • tag
  • quote

​
Response notes

Successful calls return a JSON object with a top-level data field and, when available, metadata.creditsUsed and metadata.creditsRemaining. See response format, pagination, and credits.