Skip to main content
GET
search
Returns matching posts with a cursor token to page: title, author, selftext, score, ups, upvote_ratio, num_comments, created_utc, created_at_iso, url, permalink and is_video.
Despite what the sort values suggest, every sort returns posts and only posts. Comments and media were confirmed absent from all five.
Measured at about 5 KB and 2 seconds — faster than get_reddit_search, which searches all of Reddit and pages with after instead of cursor. For the replies under a result, pass its url to get_reddit_post_comments.

Example

First time? Point any MCP client at https://mcp.aisa.one/mcp — Claude Code, Codex, Cursor, VS Code and the rest. Authorization is OAuth: the client opens a browser, you click Allow once, and there is no key to paste. Your agent then reaches every endpoint through a few meta tools: search, list_categories, get_details and batch_quote are free, batch_use is billed per call. Setup per client is in Connect via MCP; the live tool list and what each call costs are on aisa.one/mcp.
Set this endpoint up in your agent →

Request contract

  • Method and path: GET /apis/v1/reddit/subreddit/search
  • Availability: enabled
  • Request URL template: https://api.aisa.one/apis/v1/reddit/subreddit/search
  • cursor: query; optional
  • query: query; optional
  • sort: query; optional
  • subreddit: query; required
  • timeframe: query; optional
  • Runtime facts: fdf0a203e7ec628291b62272da7b8bbbe431c8f77f251ea2e65c19cd3c98fa37
Complete OpenAPI definition Effective request and pricing declaration (including authentication and referenced schemas):

Cost and request rules

Usage-based billing; Default request estimate: $0.00188 USD (not a fixed price). Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.
  • Default request reference estimate (USD): 0.00188
  • Cost contract: response_count
  • Published reference multiplier: 1.0
  • Settlement evidence source: response_body

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

cursor
string

Cursor to get more results. Get 'cursor' from previous response.

query
string

Search query to find matching content

sort
string

Sort order. For posts/media: relevance, hot, top, new, comments. For comments: relevance, top, new

Provider reference (supplier schema): {"enum":["relevance","hot","top","new","comments"],"type":"string"}.

subreddit
string
required

Subreddit name (e.g. 'Fitness', not 'r/Fitness' or a full URL)

timeframe
string

Timeframe to filter results

Provider reference (supplier schema): {"enum":["all","year","month","week","day","hour"],"type":"string"}.

Response

Successful response

success
boolean
credits_remaining
integer
posts
object[]
after
string | null
cursor
string | null