{"name":"Reddit User Posts API","description":"List the public posts a Reddit user submitted, with each post's title, subreddit, score, comment count, date and link.","api_id":"generated_a684263f118d0826e6eceb78","slug":"reddit-user-posts-api","source":{"name":"Reddit","domain":"reddit.com","url":"https://www.reddit.com/"},"category":"social_communities","countries":[],"languages":[],"record_types":[],"tags":[],"limitations":[],"updated":"2026-11-22","note":"Sample records are saved samples, not a live run. CleanedWeb is not affiliated with the source.","version":"1.0","versions":[{"major":1,"latest_minor":"1.0","status":"current","sunset_at":null}],"changelog":[{"version":"1.0","date":"2026-11-21T10:45:03.000Z","kind":"major","changes":[]}],"version_note":"Pin a major with \"version\": N in the run body (an integer). Leave it out and the call runs on the latest major. A sunset major runs on the latest major and the response says rerouted. An unknown major answers 404 catalog_version_not_found and lists the available majors.","endpoints":[{"endpoint_id":"generated_a684263f118d0826e6eceb78_search","name":"List Reddit User Posts","description":"Return records within the accepted scope.","definition_version":"39f6c08d8f77737ba00f5ec2b129046ab6a16f7f284c1b2c73e4d60af5d12102","method":"POST","path":"/v1/catalog/public/apis/generated_a684263f118d0826e6eceb78/endpoints/generated_a684263f118d0826e6eceb78_search/run","url":"https://api.cleanedweb.com/v1/catalog/public/apis/generated_a684263f118d0826e6eceb78/endpoints/generated_a684263f118d0826e6eceb78_search/run","authentication":{"type":"bearer","scheme":"Authorization: Bearer <API key>","scope":"run","note":"Reading this file and the live catalog needs no credential. A run needs a CleanedWeb account and uses the credits of its workspace.","docs":"https://cleanedweb.com/docs/run-catalog-api/"},"required_headers":[{"name":"Authorization","value":"Bearer YOUR_API_KEY","description":"An API key with the run scope."},{"name":"Idempotency-Key","value":"UNIQUE_REQUEST_ID","description":"Required. Save it before you send; reuse it only to retry the same request and to read the result. 1-200 characters: letters, numbers, . _ : -"},{"name":"Content-Type","value":"application/json","description":"The body is JSON."}],"request_body":{"input":"An object that follows input_schema.","max_items":"Optional. Stop after this many records.","timeout_seconds":"Optional, 60-86400, default 10800.","wait_seconds":"Optional, 0-86400, default 90. How long the request waits before answering 202.","version":"Optional integer major. Leave it out for the latest major."},"input_schema":{"type":"object","properties":{"enrich_records":{"type":"boolean","default":true,"description":"true: read each returned record's product/detail page and merge its fields into the record. false: return list/search-level fields only, with no detail page reads. Every returned record's detail page is read within the run's time budget; records the time budget leaves unread are returned without detail fields, and summary.record_enrichment reports how many records were enriched and why any were not (run_time_budget). Detail fields are optional."},"username":{"x-enum-labels":["spez","kn0thing"],"x-value-status":["observed","verified"],"x-source-key":"username","type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9\\-_]{0,31}$","minLength":1,"maxLength":32,"examples":["spez","kn0thing"],"x-open-values":true,"description":"Required. The name of a page of the same kind as the pages the pasted one links (any name that fits the pattern; the examples are the names it links). The site decides: a name it does not serve is refused as input_value_unverified.","not":{"type":"string","pattern":"\\n"},"x-source-route":"path_segment"},"sort":{"type":"string","enum":["hot","top_month","top_year"],"x-enum-labels":{"hot":"Hot","top_month":"top (This Month)","top_year":"top (This Year)"},"x-source-keys":["sort","t"],"x-value-status":"verified","x-combination":"unproven","description":"Order of the collection, as the site's own sort control offers it; omitted keeps the site's default order."}},"required":["username"],"additionalProperties":false},"output_schema":{"type":"object","additionalProperties":false,"required":["title","url"],"properties":{"author":{"type":"string"},"award_count":{"type":"string"},"award_icon_url":{"type":"string"},"award_id":{"type":"string"},"body":{"type":"string"},"comments":{"type":"string"},"content_href":{"type":"string"},"created_timestamp":{"type":"string","format":"date-time","x-precision":"second","description":"ISO 8601 value computed from the source's relative date text (such as '3 months ago') at delivery time; precise to about one second."},"date":{"type":"string"},"ks_id":{"type":["string"]},"post_id":{"type":["string"]},"post_type":{"type":"string"},"reddit_admin":{"type":"string"},"score":{"type":"string"},"subreddit":{"type":"string","description":"subreddit prefixed name"},"title":{"type":"string"},"upvote_ratio":{"type":"string"},"url":{"type":"string","format":"uri"},"detail_permalink":{"type":"string","description":"permalink"},"detail_content_href":{"type":"string","description":"content href"},"comment_count":{"type":"string","description":"comment count"},"domain":{"type":"string","description":"domain"},"subreddit_id":{"type":"string","description":"subreddit id"},"icon":{"type":"string","description":"icon"},"subreddit_name":{"type":"string","description":"subreddit name"},"typed_award_count":{"type":"integer","minimum":0,"description":"Reviewed numeric reading of award_count; source value is preserved."},"typed_comment_count":{"type":"integer","minimum":0,"description":"Reviewed numeric reading of comment_count; source value is preserved."},"typed_comments":{"type":"integer","minimum":0,"description":"Reviewed numeric reading of comments; source value is preserved."}}},"examples":[{"kind":"saved_validation_records","saved_at":"2026-11-21T10:45:03.567Z","live_verified":false,"request":{"input":{}},"records_shown":1,"records_saved":2,"records":[{"author":"spez","award_count":"11","award_icon_url":"https://i.redd.it/snoovatar/snoo_assets/marketing/bravo_40.png","award_id":"award_free_bravo","body":"I want to talk about a big change we're making on Reddit: we're going to evolve Reddit to being a primarily logged-in experience. This is a big change for Reddit, where we've allowed logged-out access to basically all of Reddit for the last two decades. And I don’t know about you, but as someone whose life has been defined by the open internet, it’s a big change for me. But I've come to the conclusion that this is the right decision for our platform and the right decision for our business. I wanted you all to hear directly from me about why. TL;DR We’re making the change because it’s better for user experience, better for our ads business, is more in line with safety regulations, and more protective of Reddit data. And we can do this while continuing to ensure user privacy. For users to get the best version of Reddit, it requires personalization. Reddit has evolved a lot over the last 20 years. It used to be the same product for everybody. Literally, everybody saw the same thing. But Reddit is so big now that without some personalization, it's just not relevant. Or even worse, it just doesn't work. Our goal is to help you find what’s most relevant to you and drive the community, connection and belonging that makes Reddit, reddit. This change will do that, helping surface what’s most relevant to you and quickly getting you to where you want to go—whether that's your favorite subreddit, a game you want to play, or a thread you're looking for. We'd also like more of our users to benefit from the core functionality and value of Reddit, which requires being logged in. Joining communities, voting, commenting, and participating are all fundamental to the Reddit experience. Reddit works best when people participate, set the norms in their communities, and vote to determine what’s great, and what isn’t. We all benefit when more users have that intentional relationship with Reddit. And to be clear, when we talk about logging in, we're talking about literally logging in. We don't need your name. We don't need to know who you are. We don't need to know your identity. Honestly, we don’t want to know. Reddit doesn't require this (and won’t with this change), and neither does our ads business. This allows us to protect our business and meet regulations In addition to providing the best, most cohesive product experience for users, there are a few other important reasons. The first is that access to Reddit's data corpus has to be intentional. Today, the vast majority of unauthorized access to Reddit (basically the scraping and stealing of Reddit’s data) happens through our logged-out experiences. We will continue licensing our corpus intentionally, but those commercial deals come with guardrails that protect our users and our business. Any commercial deals give us the right to say what the data can and can't be used for and how it's presented. Without those guardrails and that intentionality, we can't control who has access to Reddit data, where things go or what they're used for. There are other ways this is good for our business. It will make it easier to adapt to emerging regulations around the world, and of course, more users being logged in allows us to deliver more relevant ads. This is better for business outcomes, but it's also better for users. A non-targeted ad is just a waste of space for everybody. What about privacy? You can absolutely still have a private experience on Reddit. We've rebuilt and are re-releasing incognito mode in our app. When this is on, it’s truly private. You can browse and search Reddit without affecting your logged in account. It's read-only, but I think it's a better, more private experience than what others in the market are offering. And even when you’re logged in you can choose to opt out of personalization, though, as I've said, Reddit just won't work as well. What happens next? There are still plenty of questions that are unanswered, particularly around where the boundaries should be between logged-in and logged-out experiences. For example, the front page being available logged-out is useful and important. And we, of course, want people to be able to share posts, and for visitors arriving from search or other external sources to see the content that's being linked to. Our next step will be to test this in select markets outside the U.S. in the coming months. We'll look at the impact on the user experience, on our business, and on the whole Reddit ecosystem, figure out where the right boundaries are, and go from there. This is a big evolution for Reddit, and not one we're taking lightly. But I believe it's the right next step for the platform and for our future. Duty calls - specifically, our quarterly earnings call. Drop any questions below, and I’ll be back online in a couple hours to answer them.","comment_count":"511","comments":"511","content_href":"https://www.reddit.com/r/u_spez/comments/1xiupm0/about_that_login_screen/","created_timestamp":"2026-10-29T20:08:37Z","date":"2026-10-29T20:08:37.416000+0000","detail_content_href":"https://www.reddit.com/r/u_spez/comments/1xiupm0/about_that_login_screen/","detail_permalink":"/user/spez/comments/1xiupm0/about_that_login_screen/","domain":"self.spez","icon":"https://styles.redditmedia.com/t5_3k30p/styles/profileIcon_uj015iwx9s7g1.png?width=48&height=48&frame=1&auto=webp&crop=48%3A48%2Csmart&s=f4940ed370a17a813fda1db1cdefc8d12b3a53a7","ks_id":"t3_1xiupm0","post_id":"t3_1xiupm0","post_type":"text","score":"0","subreddit":"u_spez","subreddit_id":"t5_3k30p","subreddit_name":"u_spez","title":"About that login screen","upvote_ratio":"0.2898550724637681","url":"https://www.reddit.com/user/spez/comments/1xiupm0/about_that_login_screen/","typed_award_count":11,"typed_comment_count":511,"typed_comments":511}]}],"request_example":{"body":{"input":{"username":"spez","sort":"hot"},"version":1,"max_items":25},"curl":"curl -X POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_a684263f118d0826e6eceb78/endpoints/generated_a684263f118d0826e6eceb78_search/run \\\n  -H \"Authorization: Bearer YOUR_API_KEY\" \\\n  -H \"Idempotency-Key: UNIQUE_REQUEST_ID\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n  \"input\": {\n    \"username\": \"spez\",\n    \"sort\": \"hot\"\n  },\n  \"version\": 1,\n  \"max_items\": 25\n}'"},"result":{"method":"GET","url":"https://api.cleanedweb.com/v1/catalog/public/apis/generated_a684263f118d0826e6eceb78/endpoints/generated_a684263f118d0826e6eceb78_search/result","note":"A run that does not end within wait_seconds answers 202. Read the result with the same API key and the same Idempotency-Key."},"links":{"page":"https://cleanedweb.com/catalog/reddit-user-posts-api/","markdown":"https://cleanedweb.com/catalog/reddit-user-posts-api/index.md","live_contract":"https://app.cleanedweb.com/api/catalog/apis/generated_a684263f118d0826e6eceb78/endpoints/generated_a684263f118d0826e6eceb78_search/contract","run_docs":"https://cleanedweb.com/docs/run-catalog-api/"}}],"links":{"page":"https://cleanedweb.com/catalog/reddit-user-posts-api/","markdown":"https://cleanedweb.com/catalog/reddit-user-posts-api/index.md","contract":"https://cleanedweb.com/catalog/reddit-user-posts-api/contract.json","catalog":"https://cleanedweb.com/catalog/","index":"https://cleanedweb.com/catalog/index.json","openapi":"https://cleanedweb.com/catalog/openapi.json"}}
