Reddit NSFW Post Search

GET/v1/reddit/nsfw/search

MCPreddit_nsfw_search2 creditsLiveRequires 18+ access in settings

Updated Oct 13, 2026

Description

Search Reddit posts including adult (NSFW) content. Only works when the account owner has turned on 18+ access in the dashboard; otherwise it returns scope_denied. Returns the same post objects as reddit.search. Costs 2 credits per page. Tip: set nsfwOnly=true to drop safe-for-work posts from the results.

Parameters

Name	In	Type	Required	Default	Description
`q`	query	string	yes		Search text. Reddit operators allowed.
`subreddit`	query	string	no		Limit to one subreddit.
`sort`	query	enum	no	`relevance`	Result order. One of: `relevance`, `new`, `hot`, `top`, `comments`.
`time`	query	enum	no	`all`	Time window. One of: `hour`, `day`, `week`, `month`, `year`, `all`.
`nsfwOnly`	query	boolean,string	no		Return only posts marked NSFW.
`limit`	query	integer	no	`25`	Max rows to return (1-100). Reddit pages hold about 25 rows; larger values still return one page. Range 1 to 100.
`cursor`	query	string	no		Opaque cursor from the previous response's page.nextCursor. Length 1 to 2048.

q query, string, required: Search text. Reddit operators allowed.
subreddit query, string: Limit to one subreddit.
sort query, enum: Result order. One of: relevance, new, hot, top, comments. Default relevance.
time query, enum: Time window. One of: hour, day, week, month, year, all. Default all.
nsfwOnly query, boolean,string: Return only posts marked NSFW.
limit query, integer: Max rows to return (1-100). Reddit pages hold about 25 rows; larger values still return one page. Range 1 to 100. Default 25.
cursor query, string: Opaque cursor from the previous response's page.nextCursor. Length 1 to 2048.

Request examples

curl "https://chatterapi.com/v1/reddit/nsfw/search?q=photography&limit=10" \
  -H "Authorization: Bearer $CHATTERAPI_KEY"

Response

data is a list of RedditPost, with page.nextCursor and page.hasMore for the next page. Fields:

Field	Type	Nullable	Description
`id`	string	no	Platform id.
`fullname`	string	no	Reddit fullname (t3_ for posts, t1_ for comments). Dedupe on this.
`title`	string	no	Title.
`body`	string	no	Text body. Empty for link and media posts.
`author`	string	yes	Author username, null when deleted.
`subreddit`	string	no	Subreddit name without r/.
`permalink`	string	no	Path on reddit.com.
`url`	string	no	Full URL on the platform.
`externalUrl`	string	yes	Link the post points to, when it is a link post.
`score`	number	yes	Score (upvotes minus downvotes) as Reddit reports it.
`numComments`	number	yes	Comment count.
`upvoteRatio`	number	yes	Share of upvotes, 0 to 1.
`createdAt`	string	no	ISO 8601 UTC timestamp.
`nsfw`	boolean	no	Marked adult content.
`locked`	boolean	yes	Comments are locked.
`media`	object	yes	Images, video or gallery URLs, or null.

response

{
  "data": [
    {
      "id": "1x576li",
      "fullname": "t3_1x576li",
      "title": "When does editing a photograph stop being photography?",
      "body": "I've been thinking about how much of a photograph is reality and how much is the photographer's interpretation.\n\nExposure, contrast, color grading, cropping, black and white conversion — all of these can completely change how a scene feels without changing what was actually in front of the camera.\n\nBut where do we draw the line?\n\nIs a heavily edited landscape still an honest photograph if it captures the emotion the photographer experienced? Or should a photograph preserve the scene as faithfully as possible?\n\nI'd be interested to hear how other photographers approach this, especially when editing becomes part of their creative process.",
      "author": "Pure-Positive3607",
      "subreddit": "AskPhotography",
      "permalink": "/r/AskPhotography/comments/1x576li/when_does_editing_a_photograph_stop_being/",
      "url": "https://www.reddit.com/r/AskPhotography/comments/1x576li/when_does_editing_a_photograph_stop_being/",
      "externalUrl": null,
      "score": 0,
      "numComments": 4,
      "upvoteRatio": 0.5,
      "createdAt": "2026-10-13T20:04:04.000Z",
      "nsfw": false,
      "locked": false,
      "media": null
    },
    {
      "id": "1x5760e",
      "fullname": "t3_1x5760e",
      "title": "Natural light fungi",
      "body": "Decided to leave the flash and diffuser at home today, and found some cool fungi. Natural light is definitely a whole different ball game but I had loads of fun.  \nI'm new to photography so any advice/feedback on editing or composition is welcome :) Cheers!",
      "author": "crymax",
      "subreddit": "macrophotography",
      "permalink": "/r/macrophotography/comments/1x5760e/natural_light_fungi/",
      "url": "https://www.reddit.com/r/macrophotography/comments/1x5760e/natural_light_fungi/",
      "externalUrl": "https://www.reddit.com/gallery/1x5760e",
      "score": 1,
      "numComments": 0,
      "upvoteRatio": 1,
      "createdAt": "2026-10-13T20:03:24.000Z",
      "nsfw": false,
      "locked": false,
      "media": {
        "type": "gallery",
        "urls": [
          "https://preview.redd.it/z2w7jizcjavh1.jpg?width=2048&format=pjpg&auto=webp&s=09998e5c6994af9a23f290f1216b24640d301e0d",
          "https://preview.redd.it/0s576jzcjavh1.jpg?width=2048&format=pjpg&auto=webp&s=d90d5fed5663611b405a8507341696a05aaf0acc",
          "https://preview.redd.it/otldkfzcjavh1.jpg?width=2048&format=pjpg&auto=webp&s=d38059057dafa7c0aae384195ff4306dd43b9ebf",
          "https://preview.redd.it/vcv8pgzcjavh1.jpg?width=2048&format=pjpg&auto=webp&s=813df5d6e9527abc7b83a29c2be6e805d054290c",
          "https://preview.redd.it/kzw33gzcjavh1.jpg?width=2048&format=pjpg&auto=webp&s=1e3e3d4ad187626871335fe9e65d708958bb410f",
          "https://preview.redd.it/8t8vikzcjavh1.jpg?width=2048&format=pjpg&auto=webp&s=5b45317aca89a00ceb6e92a0575a7bb97a071b7b",
          "https://preview.redd.it/jtju9hzcjavh1.jpg?width=2048&format=pjpg&auto=webp&s=5aa5ea65e09e2285c96858c1a60a393c57f1e435",
          "https://preview.redd.it/nkr14a0djavh1.jpg?width=2048&format=pjpg&auto=webp&s=3b675aaf7e79580a56b3210329489d36821db348"
        ]
      }
    },
    {
      "id": "1x575vz",
      "fullname": "t3_1x575vz",
      "title": "15 looking for friends from Europe",
      "body": "I'm a 15 year old girl in the GMT+3 timezone. I've been really bored lately so I'd love someone to talk to either casually or to become close friends eventually). I'm into gaming, but I haven't had much time to play lately. I love Genshin Impact, Kingdom Come Deliverance, Assassin's Creed Odyssey, ULTRAKILL, Roblox. I also listen to hyperpop (Asteria, kets4eki, d3r, xaduma, Vyzer etc.) and I'm into photography, travelling, psychology, language learning and HEAVILY into pharmacology! Any age 14-17 is fine, if you're 18+ or an incel begging to date I will immediately block you, zero questions.",
      "author": "TankNo2505",
      "subreddit": "friendship",
      "permalink": "/r/friendship/comments/1x575vz/15_looking_for_friends_from_europe/",
      "url": "https://www.reddit.com/r/friendship/comments/1x575vz/15_looking_for_friends_from_europe/",
      "externalUrl": null,
      "score": 1,
      "numComments": 1,
      "upvoteRatio": 1,
      "createdAt": "2026-10-13T20:03:16.000Z",
      "nsfw": false,
      "locked": false,
      "media": null
    }
  ],
  "page": {
    "nextCursor": "eyJ2IjoxLCJwIjoiY2l0ZXJvY2tldCIsImMiOiJ0M18xeDU3MXMyIiwibyI6MCwiaCI6ImE0YWY4ZDllZjkxMyJ9",
    "hasMore": true
  },
  "credits": {
    "charged": 2,
    "remaining": 24997
  },
  "requestId": "req_01JA7Q3V8K2N4P5R6S7T8V",
  "cached": false
}

Recorded live response captured 2026-10-13, truncated to 3 items. Credits and request id are illustrative.

Credits

2 credits per call. Failed calls cost 0. Cached responses cost the same. Test keys cost 0. Repeat calls with the same input within 10 minutes are served from cache.

Reddit NSFW Post Search

Description

Parameters

Request examples

Response

Credits

Errors this tool can return

Try it

Related tools