{"name":"Reddit User Comments API","description":"List the public comments a Reddit user wrote: each comment's text, subreddit, score, date and link.","api_id":"generated_9e73455bedf41a4fe1f22e80","slug":"reddit-user-comments-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:46:29.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_9e73455bedf41a4fe1f22e80_search","name":"List Reddit User Comments","description":"Return records within the accepted scope.","definition_version":"c81b9d358e3864d6d0f2c4d71d1b72a8180d973152aa03af52ecbf27ce006dab","method":"POST","path":"/v1/catalog/public/apis/generated_9e73455bedf41a4fe1f22e80/endpoints/generated_9e73455bedf41a4fe1f22e80_search/run","url":"https://api.cleanedweb.com/v1/catalog/public/apis/generated_9e73455bedf41a4fe1f22e80/endpoints/generated_9e73455bedf41a4fe1f22e80_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":{"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,39}$","minLength":1,"maxLength":40,"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","x-input-type":{"kind":"string"}},"sort":{"x-input-proof":{"evidence":"declared","key":"sort","kind":"sort_choices","read":"listing","rule":"request_structure_v1","value":"hot","where":"query"},"type":"string","enum":["hot","new","top","top_month","top_year","top_all"],"x-enum-labels":{"hot":"Hot","new":"New","top":"Top","top_month":"top (This Month)","top_year":"top (This Year)","top_all":"top (All Time)"},"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":{"body":{"type":"string"},"date":{"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."},"feed_element_id":{"type":["string"]},"ks_id":{"type":["string"]},"linked_url":{"type":"string"},"profile_name_anchor":{"type":"string"},"score":{"type":"integer"},"subreddit":{"type":"string"},"title":{"type":"string"},"url":{"type":"string","format":"uri"}}},"examples":[{"kind":"saved_validation_records","saved_at":"2026-11-21T10:46:29.859Z","live_verified":false,"request":{"input":{}},"records_shown":2,"records_saved":2,"records":[{"body":"Pretty simple. For people who are already coming to Reddit every week, we have to give them a reason to come back everyday. If you come for sports and entertainment, or food and fashion, or new and trends, or something fun and funny, can you find it simply once you’re here. If the answer is yes, well, then you’re probably going to come back. If the answer is no, you might not. We’ve got a lot we’ll be testing in the coming months towards this end. For example, where we have For You and Following today in the app, we’ll be adding other feeds and topics so you can hopefully more easily get the vibe you’re looking for.","date":"2026-10-29T22:42:06Z","feed_element_id":"t1_19ruo33ofgh8i","ks_id":"t1_19ruo33ofgh8i","linked_url":"https://www.reddit.com/r/RDDT/comments/1xiupuc/reddit_announces_q326_earnings_plus_ama/","score":-7,"subreddit":"r/RDDT","title":"Reddit Announces Q3’26 Earnings (plus AMA!)","url":"https://www.reddit.com/r/RDDT/comments/1xiupuc/comment/19ruo33ofgh8i/?context=3"},{"body":"That was the thinking. Otherwise it would be easier to just replicate the UI.","date":"2026-08-05T18:31:50Z","feed_element_id":"t1_p1wosm9","ks_id":"t1_p1wosm9","linked_url":"https://www.reddit.com/user/spez/comments/1vgbkge/modernizing_reddits_infrastructure_with_you/","profile_name_anchor":"u/spez","score":20,"subreddit":"u/spez","title":"Modernizing Reddit’s infrastructure with you","url":"https://www.reddit.com/user/spez/comments/1vgbkge/comment/p1wosm9/?context=3"}]}],"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_9e73455bedf41a4fe1f22e80/endpoints/generated_9e73455bedf41a4fe1f22e80_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_9e73455bedf41a4fe1f22e80/endpoints/generated_9e73455bedf41a4fe1f22e80_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-comments-api/","markdown":"https://cleanedweb.com/catalog/reddit-user-comments-api/index.md","live_contract":"https://app.cleanedweb.com/api/catalog/apis/generated_9e73455bedf41a4fe1f22e80/endpoints/generated_9e73455bedf41a4fe1f22e80_search/contract","run_docs":"https://cleanedweb.com/docs/run-catalog-api/"}}],"links":{"page":"https://cleanedweb.com/catalog/reddit-user-comments-api/","markdown":"https://cleanedweb.com/catalog/reddit-user-comments-api/index.md","contract":"https://cleanedweb.com/catalog/reddit-user-comments-api/contract.json","catalog":"https://cleanedweb.com/catalog/","index":"https://cleanedweb.com/catalog/index.json","openapi":"https://cleanedweb.com/catalog/openapi.json"}}
