What you get
| Field | Type |
|---|---|
title |
string |
date |
string |
url |
string |
comments |
integer |
score |
integer |
subreddit |
string |
thingid |
string |
comment_count |
string |
All 27 fields
Key fields
titledateurlcommentsscoresubredditthingidcomment_countaward_countdomainpost_typeupvote_ratiosubreddit_prefixed_nameauthoriconsubreddit_nameflairbodypermalink
Technical fields
post_title_textcreated_timestampauthor_idpost_idcontent_hreftyped_award_counttyped_comment_counttyped_comments
Sample records
2 saved records. This is a saved sample, not a live run.
title |
date |
url |
comments |
score |
subreddit |
|---|---|---|---|---|---|
| Compiling django with Nuitka or Cython ? | 2026-10-20T00:06:54.710000+0000 | reddit.com/r/Python/comments/1xadd8u/comp… | 18 | 12 | 2026-10-20T00:06:54Z |
| it's not always about django vs fastapi/flask, you can use both | 2025-09-20T11:56:18.555000+0000 | reddit.com/r/Python/comments/1nlw9dz/its_… | 16 | 6 | 2025-09-20T11:56:18Z |
Scroll sideways to see more columns.
Inputs
-
searchstring | array of string · requiredRequired. Supply an array to union distinct results from each source search, in query order. Default: django.
-
subreddittext · requiredFree text: any subreddit the site serves, written with letters, digits, underscores and hyphens, up to 32 characters. A name the site does not serve is refused.
-
cidbooleanApplies only within type=posts: sent alone it selects type=posts too; with another type the call is refused.
-
sortchoiceOrder of the collection, as the site's own sort control offers it; omitted keeps the site's default order.
-
typechoiceOptional. Filters by type.
-
tchoiceOptional. Filters the results.
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_e995d5999f3462c337011ac0/endpoints/generated_e995d5999f3462c337011ac0_search/run
curl -X POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_e995d5999f3462c337011ac0/endpoints/generated_e995d5999f3462c337011ac0_search/run \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Idempotency-Key: UNIQUE_REQUEST_ID" \
-H "Content-Type: application/json" \
-d '{
"input": {
"search": "django",
"subreddit": "Python",
"type": "posts"
},
"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 Subreddit Search 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.