> ## Documentation Index > Fetch the complete documentation index at: https://aisa.one/docs/llms.txt > Use this file to discover all available pages before exploring further. # Search Within Subreddit > Search Within Subreddit Search for posts within a single subreddit. ## Example ```bash theme={null} curl "https://api.aisa.one/apis/v1/reddit/subreddit/search?subreddit=VALUE" \ -H "Authorization: Bearer YOUR_API_KEY" ``` ## OpenAPI ````yaml openapi/reddit.json GET /reddit/subreddit/search openapi: 3.0.0 info: title: Reddit API description: >- Read public Reddit data — search posts, browse subreddits, and fetch comments. version: 1.0.0 servers: - url: https://api.aisa.one/apis/v1 security: - bearerAuth: [] paths: /reddit/subreddit/search: get: tags: - Reddit API summary: Search Within Subreddit description: >- Searches within a specific subreddit for posts, comments, and media matching a query. Returns posts with title, votes, num_comments, url, and created_at; comments with author, body, votes, and parent post info; and media with title, media_type, image dimensions, and gallery_count. Supports sort, timeframe filtering, and cursor-based pagination. operationId: get_reddit-subreddit-search parameters: - name: subreddit in: query required: true description: Subreddit name (e.g. 'Fitness', not 'r/Fitness' or a full URL) schema: type: string - name: query in: query required: false description: Search query to find matching content schema: type: string example: push ups - name: sort in: query required: false description: >- Sort order. For posts/media: relevance, hot, top, new, comments. For comments: relevance, top, new schema: type: string enum: - relevance - hot - top - new - comments - name: timeframe in: query required: false description: Timeframe to filter results schema: type: string enum: - all - year - month - week - day - hour - name: cursor in: query required: false description: Cursor to get more results. Get 'cursor' from previous response. schema: type: string example: eyJjYW5kaWRhdGVzX3JldHVybmVkIjoi... responses: '200': description: Successful response content: application/json: example: posts: - id: t3_8gmjrb post_id: t3_8gmjrb title: Is doing 50-100 pushups a day doing anything? url: >- https://www.reddit.com/r/Fitness/comments/8gmjrb/is_doing_50100_pushups_a_day_doing_anything/ permalink: >- /r/Fitness/comments/8gmjrb/is_doing_50100_pushups_a_day_doing_anything/ nsfw: false spoiler: false is_crosspost: false subreddit: id: t5_2qhx4 name: Fitness nsfw: false quarantined: false icon: >- https://b.thumbs.redditmedia.com/Ted4KOMuRbaCYlDS55cTqjpVVZ2ENHKtYFbBFjI1i2o.png banner: null description: >- A place for the pursuit of physical fitness goals. Please see the r/Fitness Wiki and FAQ at https://thefitness.wiki for help with common questions. weekly_visitors: 898726 weekly_contributions: 1827 votes: 1414 num_comments: 582 created_at: 2018-05-03T01:09:17.620000+0000 created_at_iso: '2018-05-03T01:09:17.620Z' thumbnail: null thumbnail_blurred: false position: 0 relative_position: 0 comments: - id: t1_nxf7p27 post_id: t3_1q2p898 parent_comment_id: null is_reply_to_comment: false author: Philser23 author_avatar: null author_nsfw: false body: >- On the 30th my girlfriend out of the blue decided her new year's resolution would be to start going to the gym. I was so excited since none of my partners ever shared the fitness hobby with me. body_html: >-

On the 30th my girlfriend out of the blue decided her new year's resolution would be to start going to the gym...

images: [] votes: 123 url: >- https://www.reddit.com/r/Fitness/comments/1q2p898/gym_story_saturday/nxf7p27/ permalink: /r/Fitness/comments/1q2p898/gym_story_saturday/nxf7p27/ created_at: 2026-01-03T11:26:02.434000+0000 created_at_iso: '2026-01-03T11:26:02.434Z' post: id: t3_1q2p898 title: Gym Story Saturday url: >- https://www.reddit.com/r/Fitness/comments/1q2p898/gym_story_saturday/ permalink: /r/Fitness/comments/1q2p898/gym_story_saturday/ nsfw: false spoiler: false votes: 67 num_comments: 80 created_at: 2026-01-03T08:15:49.709000+0000 created_at_iso: '2026-01-03T08:15:49.709Z' subreddit: id: t5_2qhx4 name: Fitness nsfw: false quarantined: false icon: >- https://b.thumbs.redditmedia.com/Ted4KOMuRbaCYlDS55cTqjpVVZ2ENHKtYFbBFjI1i2o.png position: 0 media: - id: t3_geo4x title: >- Bodyweight training for really strong people. See on you're own what I mean with strong. (Not me) url: >- https://www.reddit.com/r/Fitness/comments/geo4x/bodyweight_training_for_really_strong_people_see/ permalink: >- /r/Fitness/comments/geo4x/bodyweight_training_for_really_strong_people_see/ media_type: image video: null image: src: >- https://external-preview.redd.it/X6lz5yGIzqVA5LcI9w-FsQJJHhXoCugDhsXgWW3I404.jpg?format=pjpg&auto=webp&s=46814b0a707a532e39e6c20851ddc1fefb0a111f width: 480 height: 360 resolutions: - url: >- https://external-preview.redd.it/X6lz5yGIzqVA5LcI9w-FsQJJHhXoCugDhsXgWW3I404.jpg?width=320&crop=smart&format=pjpg&auto=webp&s=144ac4171a1862e5d91d8dd90d44271e22a8273d width: 320 gallery_count: null aspect_ratio: 1.3333333333333333 nsfw: false spoiler: false is_blurred: false subreddit: id: t5_2qhx4 name: Fitness nsfw: false quarantined: false position: 0 safe_search: UNAVAILABLE cursor: >- eyJjYW5kaWRhdGVzX3JldHVybmVkIjoie1wic2VjdGlvbl8xX3BpcGVsaW5lXzBfZ2xvYmFsX21vZGlmaWVyc1wiOlwiM1wiLFwic2VjdGlvbl8xX3BpcGVsaW5lXzFfbG9jYWxfbW9kaWZpZXJzXCI6XCIzXCIsXCJzZWN0aW9uXzJfcGlwZWxpbmVfNl9zY29wZV9zd2l0Y2hlclwiOlwiMFwiLFwic2VjdGlvbl8yX3BpcGVsaW5lXzdfcG9zdF9zZWFyY2hcIjpcIjdcIn0ifQ== schema: $ref: '#/components/schemas/RedditPostsResponse' components: schemas: RedditPostsResponse: type: object properties: success: type: boolean credits_remaining: type: integer posts: type: array items: $ref: '#/components/schemas/RedditPost' after: type: string nullable: true cursor: type: string nullable: true additionalProperties: true RedditPost: type: object additionalProperties: true securitySchemes: bearerAuth: type: http scheme: bearer description: AIsa API key. Get yours at https://aisa.one ````