Skip to main content
GET
subreddit
Returns posts with an after token to page, carrying the same fields as get_reddit_search: title, author, selftext, score, ups, upvote_ratio, num_comments, created_utc, created_at_iso, url, permalink and subreddit_subscribers. sort accepts best, hot, new, top and rising.
timeframe is only accepted together with sort=top. Every other combination returns 400, rather than ignoring the parameter.
Subreddit names are case-sensitive. Measured at about 18 KB for 24 posts. To search inside the same subreddit use get_reddit_subreddit_search; for its metadata, get_reddit_subreddit_details.

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
  • Availability: enabled
  • Request URL template: https://api.aisa.one/apis/v1/reddit/subreddit
  • after: query; optional
  • cache_max_age: query; optional
  • sort: query; optional
  • subreddit: query; required
  • timeframe: query; optional
  • trim: 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

after
string

After to get more posts. Get 'after' from previous response.

cache_max_age
string
sort
string

Sort order

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

subreddit
string
required

Subreddit name

timeframe
string

Timeframe to get posts from. Runtime requires sort=top when timeframe is provided.

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

trim
string

Set to true for a trimmed down version of the response

Response

Successful response

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