Skip to content

NSFW Subreddit Finder

GET/v1/reddit/nsfw/subreddits/search
MCPreddit_nsfw_communities2 creditsLiveRequires 18+ access in settings

Updated

Description

Find subreddits including adult (NSFW) communities. Requires the account's 18+ setting, otherwise returns scope_denied. Same fields as reddit.communities. Costs 2 credits per page. Tip: set nsfwOnly=true to list only communities flagged NSFW.

Parameters

q query, string, required
Topic to find communities for.
nsfwOnly query, boolean,string
Return only communities flagged 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/subreddits/search?q=photography&limit=10" \
  -H "Authorization: Bearer $CHATTERAPI_KEY"

Response

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

FieldTypeNullableDescription
namestringnoName.
titlestringyesTitle.
descriptionstringyesDescription.
subscribersnumberyesSubscriber count.
createdAtstringyesISO 8601 UTC timestamp.
nsfwbooleanyesMarked adult content.
urlstringnoSubreddit URL.
rulesobject[]yesSubreddit rules, or null when the source cannot see them.
moderatorsobject[]yesModerators and since when, or null.
postingobjectyesPosting settings, or null.
response
{
  "data": [
    {
      "name": "photography",
      "title": "Photography",
      "description": "/r/photography is a place to politely discuss the tools, technique, art and culture of photography and to post topics that would be of interest to other photographers.",
      "subscribers": 5665551,
      "createdAt": "2008-01-25T05:32:49.000Z",
      "nsfw": false,
      "url": "https://www.reddit.com/r/photography/",
      "rules": null,
      "moderators": null,
      "posting": null
    },
    {
      "name": "AskPhotography",
      "title": "Photography community ready to help.",
      "description": "Whether you're a seasoned professional or just starting out, this subreddit is the perfect place to ask questions, seek advice, and engage in discussions about all things photography. We're here to foster a supportive and knowledgeable community that shares a passion for capturing the world through the lens.\n\nIf you're new to photography or have a burning question, don't hesitate to make a post! Our community is filled with experienced photographers who are eager to help.",
      "subscribers": 761688,
      "createdAt": "2011-12-22T18:28:22.000Z",
      "nsfw": false,
      "url": "https://www.reddit.com/r/AskPhotography/",
      "rules": null,
      "moderators": null,
      "posting": null
    },
    {
      "name": "AmateurPhotography",
      "title": "Amateur Photography",
      "description": "Welcome to /r/AmateurPhotography!",
      "subscribers": 250389,
      "createdAt": "2013-06-02T23:55:01.000Z",
      "nsfw": false,
      "url": "https://www.reddit.com/r/AmateurPhotography/",
      "rules": null,
      "moderators": null,
      "posting": null
    }
  ],
  "page": {
    "nextCursor": "eyJ2IjoxLCJwIjoiY2l0ZXJvY2tldCIsImMiOiJ0NV8ycmRlZSIsIm8iOjAsImgiOiI4YjhlZjY3NzhkY2QifQ",
    "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 24 hours are served from cache.

Errors this tool can return

Try it