Community Picker Search V2

Search for subreddits by name. Returns subreddit name, icon, subscriber count, description, NSFW flag, and allowed post types. Designed for community picker / a

GET /api/v2/search/communities

Search for subreddits by name. Returns subreddit name, icon, subscriber count, description, NSFW flag, and allowed post types. Designed for community picker / autocomplete UIs. Optionally include or exclude NSFW communities.

Query parameters

Name	Type	Required	Description
`q`	string	Yes	Search query for subreddit names
`nsfw`	string	No	Include NSFW communities: true or false (default: true)

Authentication

Header	Value
`X-RapidAPI-Key`	Your RapidAPI key
`X-RapidAPI-Host`	`red-crawler1.p.rapidapi.com`

Example request

cURL

curl -X GET "https://red-crawler1.p.rapidapi.com/api/v2/search/communities?q=ask&nsfw=true" \
  -H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
  -H "X-RapidAPI-Host: red-crawler1.p.rapidapi.com"

JavaScript

const res = await fetch("https://red-crawler1.p.rapidapi.com/api/v2/search/communities?q=ask&nsfw=true", {
  method: "GET",
  headers: {
      "X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY",
    "X-RapidAPI-Host": "red-crawler1.p.rapidapi.com"
    }
});
const data = await res.json();
console.log(data);

Python

import requests

url = "https://red-crawler1.p.rapidapi.com/api/v2/search/communities?q=ask&nsfw=true"
headers = {
    "X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY",
    "X-RapidAPI-Host": "red-crawler1.p.rapidapi.com"
}
resp = requests.get(url, headers=headers)
print(resp.json())

Example response

HTTP 200 — captured from a live call to the gateway.

{
  "success": true,
  "data": {
    "success": true,
    "data": {
      "subredditTypeahead": {
        "subreddits": {
          "edges": [
            {
              "node": {
                "id": "t5_examples",
                "name": "test",
                "type": "PUBLIC",
                "prefixedName": "r/test",
                "subscribersCount": 58390583.0,
                "isNsfw": false,
                "isQuarantined": false,
                "isUserBanned": false,
                "allowedPostTypes": [],
                "publicDescriptionText": "r/test is the place to ask and answer thought-provoking questions.",
                "styles": {
                  "icon": "\u2026",
                  "legacyIcon": "\u2026"
                },
                "modPermissions": null,
                "rules": [
                  "\u2026",
                  "\u2026",
                  "\u2026 (10 more items)"
                ],
                "isContributor": false,
                "isPostingRestricted": true
              }
            },
            {
              "node": {
                "id": "t5_examples",
                "name": "AskMen",
                "type": "PUBLIC",
                "prefixedName": "r/AskMen",
                "subscribersCount": 7238280.0,
                "isNsfw": false,
                "isQuarantined": false,
                "isUserBanned": false,
                "allowedPostTypes": [],
                "publicDescriptionText": "We're a community for men to discuss men's lived experiences. We're not a relationship advice subreddit or a place for you to figure out why a specific man does something.\n\nAsk Men, not ask ABOUT men.",
                "styles": {
                  "icon": "\u2026",
                  "legacyIcon": "\u2026"
                },
                "modPermissions": null,
                "rules": [
                  "\u2026",
                  "\u2026",
                  "\u2026 (9 more items)"
                ],
                "isContributor": false,
                "isPostingRestricted": true
              }
            },
            "\u2026 (8 more items)"
          ]
        }
      }
    }
  },
  "error": null,
  "timestamp": "2026-04-29T08:59:27.949648+00:00"
}