@@ -265,7 +265,7 @@ paths:
265265 description: |
266266 Check if a subreddit exists and return basic info (title, subscriber count, NSFW status, post types allowed).
267267
268- Uses Reddit's public JSON API (no Reddit auth needed) . Returns `exists: false` for private, banned, or nonexistent subreddits.
268+ When accountId is provided, uses authenticated Reddit OAuth API with automatic token refresh (recommended). Falls back to Reddit 's public JSON API, which may be unreliable from server IPs . Returns `exists: false` for private, banned, or nonexistent subreddits.
269269 operationId: validateSubreddit
270270 parameters:
271271 - description: Subreddit name (with or without "r/" prefix)
@@ -277,6 +277,15 @@ paths:
277277 example: programming
278278 type: string
279279 style: form
280+ - description: Reddit social account ID for authenticated lookup (recommended
281+ for reliable results)
282+ explode: true
283+ in: query
284+ name: accountId
285+ required: false
286+ schema:
287+ type: string
288+ style: form
280289 responses:
281290 "200":
282291 content:
@@ -2098,17 +2107,24 @@ paths:
20982107 content:
20992108 application/json:
21002109 example:
2101- posts :
2110+ items :
21022111 - id: 1abc234
2112+ fullname: t3_1abc234
21032113 title: How to grow on social media in 2025
21042114 selftext: Here are my tips...
21052115 author: marketingpro
21062116 subreddit: socialmedia
2117+ url: https://www.reddit.com/r/socialmedia/comments/1abc234/
2118+ permalink: https://www.reddit.com/r/socialmedia/comments/1abc234/how_to_grow/
21072119 score: 156
2108- num_comments: 42
2109- created_utc: 1730000000
2110- permalink: /r/socialmedia/comments/1abc234/how_to_grow/
2120+ numComments: 42
2121+ createdUtc: 1730000000
2122+ over18: false
2123+ stickied: false
2124+ flairText: null
2125+ isGallery: false
21112126 after: t3_1abc234
2127+ before: null
21122128 schema:
21132129 $ref: "#/components/schemas/searchReddit_200_response"
21142130 description: Search results
@@ -2191,26 +2207,42 @@ paths:
21912207 content:
21922208 application/json:
21932209 example:
2194- posts :
2210+ items :
21952211 - id: 1xyz789
2212+ fullname: t3_1xyz789
21962213 title: Top marketing trends this week
21972214 author: trendwatcher
21982215 subreddit: marketing
2216+ url: https://www.reddit.com/r/marketing/comments/1xyz789/
2217+ permalink: https://www.reddit.com/r/marketing/comments/1xyz789/top_marketing_trends/
21992218 score: 892
2200- num_comments: 134
2201- created_utc: 1730100000
2202- permalink: /r/marketing/comments/1xyz789/top_marketing_trends/
2219+ numComments: 134
2220+ createdUtc: 1730100000
2221+ over18: false
2222+ stickied: false
2223+ flairText: null
2224+ isGallery: false
22032225 - id: 1def456
2204- title: My social media strategy that worked
2226+ fullname: t3_1def456
2227+ title: Check out my grow setup
22052228 author: growthexpert
2206- subreddit: marketing
2229+ subreddit: gardening
2230+ url: https://www.reddit.com/gallery/1def456
2231+ permalink: https://www.reddit.com/r/gardening/comments/1def456/check_out_my_grow_setup/
22072232 score: 567
2208- num_comments: 89
2209- created_utc: 1730050000
2210- permalink: /r/marketing/comments/1def456/my_social_media_strategy/
2233+ numComments: 89
2234+ createdUtc: 1730050000
2235+ over18: false
2236+ stickied: false
2237+ flairText: null
2238+ isGallery: true
2239+ galleryImages:
2240+ - https://i.redd.it/abc123.jpg
2241+ - https://i.redd.it/def456.jpg
22112242 after: t3_1def456
2243+ before: null
22122244 schema:
2213- $ref: "#/components/schemas/getRedditFeed_200_response "
2245+ $ref: "#/components/schemas/searchReddit_200_response "
22142246 description: Feed items
22152247 "400":
22162248 description: Missing params
@@ -14927,6 +14959,75 @@ components:
1492714959 $ref: "#/components/schemas/inline_object_1"
1492814960 description: Resource not found
1492914961 schemas:
14962+ RedditPost:
14963+ description: A normalized Reddit post returned by the feed and search endpoints
14964+ example:
14965+ selftext: selftext
14966+ over18: true
14967+ author: author
14968+ flairText: flairText
14969+ title: title
14970+ subreddit: subreddit
14971+ url: url
14972+ score: 6
14973+ numComments: 1
14974+ stickied: true
14975+ isGallery: true
14976+ id: id
14977+ fullname: fullname
14978+ permalink: permalink
14979+ createdUtc: 0.8008281904610115
14980+ galleryImages:
14981+ - https://openapi-generator.tech
14982+ - https://openapi-generator.tech
14983+ properties:
14984+ id:
14985+ description: Reddit post ID (without type prefix)
14986+ type: string
14987+ fullname:
14988+ description: Reddit fullname (e.g. t3_abc123)
14989+ type: string
14990+ title:
14991+ type: string
14992+ author:
14993+ type: string
14994+ subreddit:
14995+ type: string
14996+ url:
14997+ description: Post URL (may be a gallery URL
14998+ type: string
14999+ permalink:
15000+ description: Full permalink to the Reddit post
15001+ type: string
15002+ selftext:
15003+ description: Self-post body text (empty string for link posts)
15004+ type: string
15005+ createdUtc:
15006+ description: Unix timestamp of post creation
15007+ type: number
15008+ score:
15009+ type: integer
15010+ numComments:
15011+ type: integer
15012+ over18:
15013+ description: Whether the post is marked NSFW
15014+ type: boolean
15015+ stickied:
15016+ type: boolean
15017+ flairText:
15018+ description: Link flair text if set
15019+ type: string
15020+ nullable: true
15021+ isGallery:
15022+ description: Whether the post is a gallery with multiple images
15023+ type: boolean
15024+ galleryImages:
15025+ description: Individual image URLs for gallery posts (only present when
15026+ isGallery is true)
15027+ items:
15028+ format: uri
15029+ type: string
15030+ type: array
1493015031 ErrorResponse:
1493115032 example:
1493215033 details:
@@ -21581,78 +21682,58 @@ components:
2158121682 - video
2158221683 - document
2158321684 type: string
21584- searchReddit_200_response_posts_inner:
21585- example:
21586- score: 0
21587- num_comments: 6
21588- selftext: selftext
21589- author: author
21590- id: id
21591- title: title
21592- created_utc: 1.4658129805029452
21593- permalink: permalink
21594- subreddit: subreddit
21595- properties:
21596- id:
21597- type: string
21598- title:
21599- type: string
21600- selftext:
21601- type: string
21602- author:
21603- type: string
21604- subreddit:
21605- type: string
21606- score:
21607- type: integer
21608- num_comments:
21609- type: integer
21610- created_utc:
21611- type: number
21612- permalink:
21613- type: string
2161421685 searchReddit_200_response:
2161521686 example:
21687+ before: before
2161621688 after: after
21617- posts:
21618- - score: 0
21619- num_comments: 6
21620- selftext: selftext
21689+ items:
21690+ - selftext: selftext
21691+ over18: true
2162121692 author: author
21622- id: id
21693+ flairText: flairText
2162321694 title: title
21624- created_utc: 1.4658129805029452
21625- permalink: permalink
2162621695 subreddit: subreddit
21627- - score: 0
21628- num_comments: 6
21629- selftext: selftext
21630- author: author
21696+ url: url
21697+ score: 6
21698+ numComments: 1
21699+ stickied: true
21700+ isGallery: true
2163121701 id: id
21632- title: title
21633- created_utc: 1.4658129805029452
21702+ fullname: fullname
2163421703 permalink: permalink
21704+ createdUtc: 0.8008281904610115
21705+ galleryImages:
21706+ - https://openapi-generator.tech
21707+ - https://openapi-generator.tech
21708+ - selftext: selftext
21709+ over18: true
21710+ author: author
21711+ flairText: flairText
21712+ title: title
2163521713 subreddit: subreddit
21714+ url: url
21715+ score: 6
21716+ numComments: 1
21717+ stickied: true
21718+ isGallery: true
21719+ id: id
21720+ fullname: fullname
21721+ permalink: permalink
21722+ createdUtc: 0.8008281904610115
21723+ galleryImages:
21724+ - https://openapi-generator.tech
21725+ - https://openapi-generator.tech
2163621726 properties:
21637- posts :
21727+ items :
2163821728 items:
21639- $ref: "#/components/schemas/searchReddit_200_response_posts_inner "
21729+ $ref: "#/components/schemas/RedditPost "
2164021730 type: array
2164121731 after:
2164221732 type: string
21643- getRedditFeed_200_response:
21644- example:
21645- after: after
21646- posts:
21647- - "{}"
21648- - "{}"
21649- properties:
21650- posts:
21651- items:
21652- type: object
21653- type: array
21654- after:
21733+ nullable: true
21734+ before:
2165521735 type: string
21736+ nullable: true
2165621737 createPost_request_mediaItems_inner:
2165721738 properties:
2165821739 type:
![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4&size=40){kind=avatar}
0 commit comments