{"openapi":"3.1.0","info":{"title":"Reddit API","version":"1.0.0","description":"Real-time Reddit data as an API — subreddits, posts, comments, user profiles and search, returned as clean JSON. Pull a subreddit's info and its hot, new, top or rising posts; fetch a post together with its full comment tree; look up any user's profile, karma, submissions and comments; search posts across all of Reddit or within one subreddit; and list the trending posts and the most popular subreddits. Live data, paginated with Reddit cursors, with scores, upvote ratios, comment counts, flair, timestamps, thumbnails and media URLs. Ideal for social listening and brand monitoring, trend and sentiment dashboards, content aggregation, research and market intelligence, and bots. 11 data endpoints. Authenticated with an x-oanor-key; fair-use rate limits per plan.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/reddit-api","description":"oanor gateway"}],"tags":[{"name":"Subreddit"},{"name":"Posts"},{"name":"Users"},{"name":"Search"},{"name":"Popular"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/subreddit/about":{"get":{"operationId":"get_v1_subreddit_about","tags":["Subreddit"],"summary":"Subreddit info","description":"","parameters":[{"name":"subreddit","in":"query","required":true,"description":"Subreddit name (without r/)","schema":{"type":"string"},"example":"programming"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/subreddit/posts":{"get":{"operationId":"get_v1_subreddit_posts","tags":["Subreddit"],"summary":"Subreddit posts","description":"","parameters":[{"name":"subreddit","in":"query","required":true,"description":"Subreddit name","schema":{"type":"string"},"example":"worldnews"},{"name":"sort","in":"query","required":false,"description":"hot, new, top, rising","schema":{"type":"string"},"example":"hot"},{"name":"time","in":"query","required":false,"description":"For top: hour/day/week/month/year/all","schema":{"type":"string"},"example":"day"},{"name":"limit","in":"query","required":false,"description":"Max posts (1–100)","schema":{"type":"string"},"example":"10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/subreddit/rules":{"get":{"operationId":"get_v1_subreddit_rules","tags":["Subreddit"],"summary":"Subreddit rules","description":"","parameters":[{"name":"subreddit","in":"query","required":true,"description":"Subreddit name","schema":{"type":"string"},"example":"AskReddit"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/post/comments":{"get":{"operationId":"get_v1_post_comments","tags":["Posts"],"summary":"Post with comments","description":"","parameters":[{"name":"subreddit","in":"query","required":true,"description":"Subreddit name","schema":{"type":"string"},"example":"IAmA"},{"name":"post_id","in":"query","required":true,"description":"Post id (base36)","schema":{"type":"string"},"example":"z1c9z"},{"name":"limit","in":"query","required":false,"description":"Max comments","schema":{"type":"string"},"example":"10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/user/about":{"get":{"operationId":"get_v1_user_about","tags":["Users"],"summary":"User profile","description":"","parameters":[{"name":"username","in":"query","required":true,"description":"Reddit username (without u/)","schema":{"type":"string"},"example":"spez"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/user/comments":{"get":{"operationId":"get_v1_user_comments","tags":["Users"],"summary":"User comments","description":"","parameters":[{"name":"username","in":"query","required":true,"description":"Reddit username","schema":{"type":"string"},"example":"spez"},{"name":"limit","in":"query","required":false,"description":"Max comments","schema":{"type":"string"},"example":"10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/user/posts":{"get":{"operationId":"get_v1_user_posts","tags":["Users"],"summary":"User submissions","description":"","parameters":[{"name":"username","in":"query","required":true,"description":"Reddit username","schema":{"type":"string"},"example":"spez"},{"name":"sort","in":"query","required":false,"description":"new, hot, top","schema":{"type":"string"},"example":"new"},{"name":"limit","in":"query","required":false,"description":"Max posts","schema":{"type":"string"},"example":"10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search/posts":{"get":{"operationId":"get_v1_search_posts","tags":["Search"],"summary":"Search posts","description":"","parameters":[{"name":"query","in":"query","required":true,"description":"Search query","schema":{"type":"string"},"example":"chatgpt"},{"name":"subreddit","in":"query","required":false,"description":"Restrict to a subreddit","schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"description":"relevance, hot, top, new, comments","schema":{"type":"string"},"example":"relevance"},{"name":"time","in":"query","required":false,"description":"hour/day/week/month/year/all","schema":{"type":"string"},"example":"all"},{"name":"limit","in":"query","required":false,"description":"Max posts","schema":{"type":"string"},"example":"10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search/subreddits":{"get":{"operationId":"get_v1_search_subreddits","tags":["Search"],"summary":"Search subreddits","description":"","parameters":[{"name":"query","in":"query","required":true,"description":"Search query","schema":{"type":"string"},"example":"python"},{"name":"limit","in":"query","required":false,"description":"Max subreddits","schema":{"type":"string"},"example":"10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/popular/posts":{"get":{"operationId":"get_v1_popular_posts","tags":["Popular"],"summary":"Trending posts","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"Max posts","schema":{"type":"string"},"example":"10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/popular/subreddits":{"get":{"operationId":"get_v1_popular_subreddits","tags":["Popular"],"summary":"Popular subreddits","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"Max subreddits","schema":{"type":"string"},"example":"10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Spec","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":500,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":990,"monthly_call_quota":20000,"rps_limit":10,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3900,"monthly_call_quota":120000,"rps_limit":25,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":12900,"monthly_call_quota":600000,"rps_limit":60,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/reddit-api"}