{"openapi":"3.2.0","info":{"title":"Reddit API","description":"Reddit Data API offers streamlined access to Reddit’s public data, like posts, comments, user activity, and subreddit trends. Designed for developers and researchers, it simplifies data extraction and analysis without requiring direct integration with Reddit’s official API.","version":"1.0.0"},"servers":[{"url":"https://reddit.jojapi.net"}],"security":[{"ApiKeyAuth":[]}],"tags":[{"name":"Explore"},{"name":"Subreddit"},{"name":"Subreddit Posts"},{"name":"Subreddit Wiki"},{"name":"User"}],"paths":{"/search":{"get":{"operationId":"get_search","summary":"Search","tags":["Explore"],"parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","title":"Search query"}},{"name":"after","in":"query","required":false,"schema":{"type":"string"}},{"name":"before","in":"query","required":false,"schema":{"type":"string"}},{"name":"category","in":"query","required":false,"schema":{"type":"string"}},{"name":"count","in":"query","required":false,"schema":{"type":"string"}},{"name":"include_facets","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string"}},{"name":"restrict_sr","in":"query","required":false,"schema":{"type":"string"}},{"name":"show","in":"query","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string"}},{"name":"sr_detail","in":"query","required":false,"schema":{"type":"string"}},{"name":"t","in":"query","required":false,"schema":{"type":"string"}},{"name":"type","in":"query","required":false,"schema":{"type":"string"}}]}},"/by_id":{"get":{"operationId":"get_by_id","summary":"By ID","tags":["Explore"],"parameters":[{"name":"names","in":"query","required":false,"schema":{"type":"string","example":"t3_1gae6uo,t3_1fmroq6,t3_15bfi0"}}]}},"/best":{"get":{"operationId":"get_best","summary":"Best","tags":["Explore"],"parameters":[{"name":"after","in":"query","required":false,"schema":{"type":"string"}},{"name":"before","in":"query","required":false,"schema":{"type":"string"}},{"name":"count","in":"query","required":false,"schema":{"type":"string","example":"0"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string","example":"25"}},{"name":"show","in":"query","required":false,"schema":{"type":"string"}},{"name":"sr_detail","in":"query","required":false,"schema":{"type":"string"}}]}},"/hot":{"get":{"operationId":"get_hot","summary":"Hot","tags":["Explore"],"parameters":[{"name":"t","in":"query","required":false,"schema":{"type":"string"}},{"name":"after","in":"query","required":false,"schema":{"type":"string"}},{"name":"before","in":"query","required":false,"schema":{"type":"string"}},{"name":"count","in":"query","required":false,"schema":{"type":"string","example":"0"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string","example":"25"}},{"name":"show","in":"query","required":false,"schema":{"type":"string"}},{"name":"sr_detail","in":"query","required":false,"schema":{"type":"string"}}]}},"/new":{"get":{"operationId":"get_new","summary":"New","tags":["Explore"],"parameters":[{"name":"t","in":"query","required":false,"schema":{"type":"string"}},{"name":"after","in":"query","required":false,"schema":{"type":"string"}},{"name":"before","in":"query","required":false,"schema":{"type":"string"}},{"name":"count","in":"query","required":false,"schema":{"type":"string","example":"0"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string","example":"25"}},{"name":"show","in":"query","required":false,"schema":{"type":"string"}},{"name":"sr_detail","in":"query","required":false,"schema":{"type":"string"}}]}},"/top":{"get":{"operationId":"get_top","summary":"Top","tags":["Explore"],"parameters":[{"name":"t","in":"query","required":false,"schema":{"type":"string"}},{"name":"after","in":"query","required":false,"schema":{"type":"string"}},{"name":"before","in":"query","required":false,"schema":{"type":"string"}},{"name":"count","in":"query","required":false,"schema":{"type":"string","example":"0"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string","example":"25"}},{"name":"show","in":"query","required":false,"schema":{"type":"string"}},{"name":"sr_detail","in":"query","required":false,"schema":{"type":"string"}}]}},"/rising":{"get":{"operationId":"get_rising","summary":"Rising","tags":["Explore"],"parameters":[{"name":"t","in":"query","required":false,"schema":{"type":"string"}},{"name":"after","in":"query","required":false,"schema":{"type":"string"}},{"name":"before","in":"query","required":false,"schema":{"type":"string"}},{"name":"count","in":"query","required":false,"schema":{"type":"string","example":"0"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string","example":"25"}},{"name":"show","in":"query","required":false,"schema":{"type":"string"}},{"name":"sr_detail","in":"query","required":false,"schema":{"type":"string"}}]}},"/controversial":{"get":{"operationId":"get_controversial","summary":"Controversial","tags":["Explore"],"parameters":[{"name":"t","in":"query","required":false,"schema":{"type":"string"}},{"name":"after","in":"query","required":false,"schema":{"type":"string"}},{"name":"before","in":"query","required":false,"schema":{"type":"string"}},{"name":"count","in":"query","required":false,"schema":{"type":"string","example":"0"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string","example":"25"}},{"name":"show","in":"query","required":false,"schema":{"type":"string"}},{"name":"sr_detail","in":"query","required":false,"schema":{"type":"string"}}]}},"/comments":{"get":{"operationId":"get_comments","summary":"Get Comment","tags":["Explore"],"parameters":[{"name":"comment_id","in":"query","required":false,"schema":{"type":"string"}}]}},"/subreddits_search":{"get":{"operationId":"get_subreddits_search","summary":"Search Subreddits","tags":["Subreddit"],"parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","title":"Search query"}},{"name":"after","in":"query","required":false,"schema":{"type":"string"}},{"name":"before","in":"query","required":false,"schema":{"type":"string"}},{"name":"count","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string"}},{"name":"search_query_id","in":"query","required":false,"schema":{"type":"string"}},{"name":"show","in":"query","required":false,"schema":{"type":"string"}},{"name":"show_users","in":"query","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string"}},{"name":"sr_detail","in":"query","required":false,"schema":{"type":"string"}},{"name":"typeahead_active","in":"query","required":false,"schema":{"type":"string"}}]}},"/subreddit_comments":{"get":{"operationId":"get_subreddit_comments","summary":"Subreddit Comments","tags":["Subreddit"],"parameters":[{"name":"subreddit","in":"query","required":false,"schema":{"type":"string","example":"politics"}},{"name":"article","in":"query","required":false,"schema":{"type":"string"}},{"name":"comment","in":"query","required":false,"schema":{"type":"string"}},{"name":"context","in":"query","required":false,"schema":{"type":"string"}},{"name":"depth","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string"}},{"name":"showedits","in":"query","required":false,"schema":{"type":"string"}},{"name":"showmedia","in":"query","required":false,"schema":{"type":"string"}},{"name":"showmore","in":"query","required":false,"schema":{"type":"string"}},{"name":"showtitle","in":"query","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string"}},{"name":"sr_detail","in":"query","required":false,"schema":{"type":"string"}},{"name":"theme","in":"query","required":false,"schema":{"type":"string"}},{"name":"threaded","in":"query","required":false,"schema":{"type":"string"}},{"name":"truncate","in":"query","required":false,"schema":{"type":"string"}}]}},"/subreddit_search":{"get":{"operationId":"get_subreddit_search","summary":"Subreddit Search","tags":["Subreddit"],"parameters":[{"name":"subreddit","in":"query","required":false,"schema":{"type":"string","example":"politics"}},{"name":"q","in":"query","required":false,"schema":{"type":"string"}},{"name":"after","in":"query","required":false,"schema":{"type":"string"}},{"name":"before","in":"query","required":false,"schema":{"type":"string"}},{"name":"category","in":"query","required":false,"schema":{"type":"string"}},{"name":"count","in":"query","required":false,"schema":{"type":"string","example":"0"}},{"name":"include_facets","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string","example":"25"}},{"name":"restrict_sr","in":"query","required":false,"schema":{"type":"string"}},{"name":"show","in":"query","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string"}},{"name":"sr_detail","in":"query","required":false,"schema":{"type":"string"}},{"name":"t","in":"query","required":false,"schema":{"type":"string"}},{"name":"type","in":"query","required":false,"schema":{"type":"string"}}]}},"/subreddit_about":{"get":{"operationId":"get_subreddit_about","summary":"Subreddit About","tags":["Subreddit"],"parameters":[{"name":"subreddit","in":"query","required":false,"schema":{"type":"string","example":"politics"}}]}},"/subreddit_moderators":{"get":{"operationId":"get_subreddit_moderators","summary":"Subreddit Moderators","tags":["Subreddit"],"parameters":[{"name":"subreddit","in":"query","required":false,"schema":{"type":"string","example":"politics"}}]}},"/subreddit_rules":{"get":{"operationId":"get_subreddit_rules","summary":"Subreddit Rules","tags":["Subreddit"],"parameters":[{"name":"subreddit","in":"query","required":false,"schema":{"type":"string","example":"politics"}}]}},"/subreddit_posts":{"get":{"operationId":"get_subreddit_posts","summary":"Subreddit Posts","tags":["Subreddit Posts"],"parameters":[{"name":"subreddit","in":"query","required":false,"schema":{"type":"string","example":"politics"}},{"name":"after","in":"query","required":false,"schema":{"type":"string"}},{"name":"before","in":"query","required":false,"schema":{"type":"string"}},{"name":"category","in":"query","required":false,"schema":{"type":"string"}},{"name":"count","in":"query","required":false,"schema":{"type":"string","example":"0"}},{"name":"include_facets","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string","example":"25"}},{"name":"q","in":"query","required":false,"schema":{"type":"string"}},{"name":"restrict_sr","in":"query","required":false,"schema":{"type":"string"}},{"name":"show","in":"query","required":false,"schema":{"type":"string"}},{"name":"sr_detail","in":"query","required":false,"schema":{"type":"string"}},{"name":"t","in":"query","required":false,"schema":{"type":"string"}},{"name":"type","in":"query","required":false,"schema":{"type":"string"}}]}},"/subreddit_hot":{"get":{"operationId":"get_subreddit_hot","summary":"Subreddit Posts > Hot","tags":["Subreddit Posts"],"parameters":[{"name":"subreddit","in":"query","required":false,"schema":{"type":"string","example":"politics"}},{"name":"g","in":"query","required":false,"schema":{"type":"string"}},{"name":"after","in":"query","required":false,"schema":{"type":"string"}},{"name":"before","in":"query","required":false,"schema":{"type":"string"}},{"name":"count","in":"query","required":false,"schema":{"type":"string","example":"0"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string","example":"25"}},{"name":"show","in":"query","required":false,"schema":{"type":"string"}},{"name":"sr_detail","in":"query","required":false,"schema":{"type":"string"}}]}},"/subreddit_new":{"get":{"operationId":"get_subreddit_new","summary":"Subreddit Posts > New","tags":["Subreddit Posts"],"parameters":[{"name":"subreddit","in":"query","required":false,"schema":{"type":"string","example":"politics"}},{"name":"after","in":"query","required":false,"schema":{"type":"string"}},{"name":"before","in":"query","required":false,"schema":{"type":"string"}},{"name":"count","in":"query","required":false,"schema":{"type":"string","example":"0"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string","example":"25"}},{"name":"show","in":"query","required":false,"schema":{"type":"string"}},{"name":"sr_detail","in":"query","required":false,"schema":{"type":"string"}}]}},"/subreddit_top":{"get":{"operationId":"get_subreddit_top","summary":"Subreddit Posts > Top","tags":["Subreddit Posts"],"parameters":[{"name":"subreddit","in":"query","required":false,"schema":{"type":"string","example":"politics"}},{"name":"t","in":"query","required":false,"schema":{"type":"string"}},{"name":"after","in":"query","required":false,"schema":{"type":"string"}},{"name":"before","in":"query","required":false,"schema":{"type":"string"}},{"name":"count","in":"query","required":false,"schema":{"type":"string","example":"0"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string","example":"25"}},{"name":"show","in":"query","required":false,"schema":{"type":"string"}},{"name":"sr_detail","in":"query","required":false,"schema":{"type":"string"}}]}},"/subreddit_rising":{"get":{"operationId":"get_subreddit_rising","summary":"Subreddit Posts > Rising","tags":["Subreddit Posts"],"parameters":[{"name":"subreddit","in":"query","required":false,"schema":{"type":"string","example":"politics"}},{"name":"after","in":"query","required":false,"schema":{"type":"string"}},{"name":"before","in":"query","required":false,"schema":{"type":"string"}},{"name":"count","in":"query","required":false,"schema":{"type":"string","example":"0"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string","example":"25"}},{"name":"show","in":"query","required":false,"schema":{"type":"string"}},{"name":"sr_detail","in":"query","required":false,"schema":{"type":"string"}}]}},"/subreddit_controversial":{"get":{"operationId":"get_subreddit_controversial","summary":"Subreddit Posts > Controversial","tags":["Subreddit Posts"],"parameters":[{"name":"subreddit","in":"query","required":false,"schema":{"type":"string","example":"politics"}},{"name":"t","in":"query","required":false,"schema":{"type":"string"}},{"name":"after","in":"query","required":false,"schema":{"type":"string"}},{"name":"before","in":"query","required":false,"schema":{"type":"string"}},{"name":"count","in":"query","required":false,"schema":{"type":"string","example":"0"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string","example":"25"}},{"name":"show","in":"query","required":false,"schema":{"type":"string"}},{"name":"sr_detail","in":"query","required":false,"schema":{"type":"string"}}]}},"/subreddit_wiki_index":{"get":{"operationId":"get_subreddit_wiki_index","summary":"Subreddit Wiki Index","tags":["Subreddit Wiki"],"parameters":[{"name":"subreddit","in":"query","required":false,"schema":{"type":"string","example":"politics"}}]}},"/subreddit_wiki_revisions":{"get":{"operationId":"get_subreddit_wiki_revisions","summary":"Subreddit Wiki Revisions","tags":["Subreddit Wiki"],"parameters":[{"name":"subreddit","in":"query","required":false,"schema":{"type":"string","example":"politics"}}]}},"/subreddit_wiki_pages":{"get":{"operationId":"get_subreddit_wiki_pages","summary":"Subreddit Wiki Pages","tags":["Subreddit Wiki"],"parameters":[{"name":"subreddit","in":"query","required":false,"schema":{"type":"string","example":"politics"}}]}},"/subreddit_wiki_page":{"get":{"operationId":"get_subreddit_wiki_page","summary":"Subreddit Wiki Page","tags":["Subreddit Wiki"],"parameters":[{"name":"subreddit","in":"query","required":false,"schema":{"type":"string","example":"politics"}},{"name":"page","in":"query","required":false,"schema":{"type":"string","example":"approveddomainslist"}}]}},"/subreddit_wiki_page_revisions":{"get":{"operationId":"get_subreddit_wiki_page_revisions","summary":"Subreddit Wiki Page Revisions","tags":["Subreddit Wiki"],"parameters":[{"name":"subreddit","in":"query","required":false,"schema":{"type":"string","example":"politics"}},{"name":"page","in":"query","required":false,"schema":{"type":"string","example":"approveddomainslist"}}]}},"/subreddit_wiki_page_discussions":{"get":{"operationId":"get_subreddit_wiki_page_discussions","summary":"Subreddit Wiki Page Discussions","tags":["Subreddit Wiki"],"parameters":[{"name":"subreddit","in":"query","required":false,"schema":{"type":"string","example":"politics"}},{"name":"page","in":"query","required":false,"schema":{"type":"string","example":"approveddomainslist"}}]}},"/user_overview":{"get":{"operationId":"get_user_overview","summary":"User Overview","tags":["User"],"parameters":[{"name":"user","in":"query","required":false,"schema":{"type":"string","example":"hansjens47"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string"}},{"name":"t","in":"query","required":false,"schema":{"type":"string"}}]}},"/user_posts":{"get":{"operationId":"get_user_posts","summary":"User Posts","tags":["User"],"parameters":[{"name":"user","in":"query","required":false,"schema":{"type":"string","example":"hansjens47"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string"}},{"name":"t","in":"query","required":false,"schema":{"type":"string"}},{"name":"context","in":"query","required":false,"schema":{"type":"string"}},{"name":"show","in":"query","required":false,"schema":{"type":"string"}},{"name":"type","in":"query","required":false,"schema":{"type":"string"}},{"name":"after","in":"query","required":false,"schema":{"type":"string"}},{"name":"before","in":"query","required":false,"schema":{"type":"string"}},{"name":"count","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string"}},{"name":"sr_detail","in":"query","required":false,"schema":{"type":"string"}}]}},"/user_comments":{"get":{"operationId":"get_user_comments","summary":"User Comments","tags":["User"],"parameters":[{"name":"user","in":"query","required":false,"schema":{"type":"string","example":"hansjens47"}},{"name":"context","in":"query","required":false,"schema":{"type":"string"}},{"name":"show","in":"query","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string"}},{"name":"t","in":"query","required":false,"schema":{"type":"string"}},{"name":"type","in":"query","required":false,"schema":{"type":"string"}},{"name":"after","in":"query","required":false,"schema":{"type":"string"}},{"name":"before","in":"query","required":false,"schema":{"type":"string"}},{"name":"count","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string"}},{"name":"sr_detail","in":"query","required":false,"schema":{"type":"string"}}]}},"/user_search":{"get":{"operationId":"get_user_search","summary":"User Search","tags":["User"],"parameters":[{"name":"user","in":"query","required":false,"schema":{"type":"string","example":"hansjens47"}},{"name":"q","in":"query","required":false,"schema":{"type":"string"}},{"name":"type","in":"query","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string"}},{"name":"t","in":"query","required":false,"schema":{"type":"string"}}]}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-JoJAPI-Key","description":"Your JoJ API key."}}}}