What you get
| Field | Type |
|---|---|
title |
string |
date |
string |
url |
string |
author |
string |
award_count |
string |
award_icon_url |
string |
body |
string |
comments |
string |
All 28 fields
Key fields
titledateurlauthoraward_countaward_icon_urlbodycommentscontent_hrefcreated_timestamppost_typescoresubredditupvote_ratiodomainicon
Technical fields
award_idks_idpost_idreddit_admindetail_permalinkdetail_content_hrefcomment_countsubreddit_idsubreddit_nametyped_award_counttyped_comment_counttyped_comments
Sample records
1 of 2 saved records. This is a saved sample, not a live run.
title |
date |
url |
author |
award_count |
award_icon_url |
|---|---|---|---|---|---|
| About that login screen | 2026-10-29T20:08:37.416000+0000 | reddit.com/user/spez/comments/1xiupm0/abo… | spez | 11 | i.redd.it/snoovatar/snoo_assets/marketing… |
Scroll sideways to see more columns.
Inputs
-
usernametext · requiredFree text: any username the site serves, written with letters, digits, underscores and hyphens, up to 32 characters. A name the site does not serve is refused.
-
sortchoiceOrder of the collection, as the site's own sort control offers it; omitted keeps the site's default order.
enrich_records is on by default and adds the fields that only appear on each record's detail page. Send false to read list fields only. See Run an API.
Request
POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_a684263f118d0826e6eceb78/endpoints/generated_a684263f118d0826e6eceb78_search/run
curl -X POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_a684263f118d0826e6eceb78/endpoints/generated_a684263f118d0826e6eceb78_search/run \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Idempotency-Key: UNIQUE_REQUEST_ID" \
-H "Content-Type: application/json" \
-d '{
"input": {
"username": "spez",
"sort": "hot"
},
"version": 1,
"max_items": 25
}'
Save the Idempotency-Key before you send, and reuse it only to retry the same request. The key needs the run scope. See Run a catalog API.
version pins major v1, whose newest minor (1.0) answers. Leave it out and the call runs on the latest major.
Changelog
-
v1.0 (major) ·
Use it from an AI agent
Open in your coding agent
Add CleanedWeb to your agent as an MCP server, such as a custom connector in Claude or ChatGPT, then sign in with your CleanedWeb account. An API key with the read and run scopes works too.
https://api.cleanedweb.com/mcp?profile=catalog
Then ask, for example: Use CleanedWeb to get 25 records from the Reddit User Posts API.
The agent finds the API, runs it and reads the records. Runs are charged like any other run.
Coverage
- Category
- Social & communities
A run stops when the source has no more records, or when it reaches a limit you set: the number of records, the time, or your budget.
CleanedWeb is not affiliated with Reddit.