Search Posts V1

Search Reddit posts by keyword. NSFW results are always included. Use V2 for SFW+NSFW control. Supports sort, time filter, subreddit scope.

GET /api/v1/discover/content

Search Reddit posts by keyword. NSFW results are always included. Use V2 for SFW+NSFW control. Supports sort, time filter, subreddit scope.

Query parameters

Name	Type	Required	Description
`query`	string	Yes	Search keyword. NSFW is always on by default — use V2 for SFW+NSFW control.
`subreddit`	string	No	Limit search to a specific community (e.g. python).
`limit`	number	No	Number of results (1-250). Default: 25.
`time_filter`	string	No	Time filter: hour, day, week, month, year, all. Default: all.
`sort`	string	No	Sort: relevance, hot, top, new, comments. Default: relevance.
`cursor`	string	No	Pagination cursor from previous response.

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/v1/discover/content?query=python&subreddit=test&limit=25&time_filter=all&sort=relevance&cursor=<cursor>" \
  -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/v1/discover/content?query=python&subreddit=test&limit=25&time_filter=all&sort=relevance&cursor=<cursor>", {
  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/v1/discover/content?query=python&subreddit=test&limit=25&time_filter=all&sort=relevance&cursor=<cursor>"
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": {
    "posts": [
      {
        "subreddit": "test",
        "selftext": "test",
        "author_fullname": "t2_exampleu",
        "saved": false,
        "gilded": 0,
        "clicked": false,
        "title": "just fucking work you stupid python code!",
        "link_flair_richtext": [],
        "subreddit_name_prefixed": "r/test",
        "hidden": false,
        "link_flair_css_class": null,
        "downs": 0,
        "thumbnail_height": null,
        "hide_score": false,
        "name": "t3_1sys4r2",
        "quarantine": false,
        "link_flair_text_color": "dark",
        "upvote_ratio": 1.0,
        "author_flair_background_color": null,
        "ups": 2,
        "total_awards_received": 0,
        "media_embed": {},
        "thumbnail_width": null,
        "is_original_content": false,
        "secure_media": null,
        "is_reddit_media_domain": false,
        "is_meta": false,
        "category": null,
        "secure_media_embed": {},
        "link_flair_text": null,
        "score": 2,
        "is_created_from_ads_ui": false,
        "author_premium": false,
        "thumbnail": "self",
        "edited": false,
        "author_flair_css_class": null,
        "author_flair_richtext": [],
        "gildings": {},
        "content_categories": null,
        "is_self": true,
        "created": 1487557007.0,
        "link_flair_type": "text",
        "removed_by_category": null,
        "author_flair_type": "text",
        "domain": "self.test",
        "allow_live_comments": false,
        "selftext_html": "<!-- SC_OFF --><div class=\"md\"><p>test</p>\n</div><!-- SC_ON -->",
        "likes": null,
        "suggested_sort": null,
        "archived": false,
        "is_crosspostable": false,
        "pinned": false,
        "over_18": false,
        "all_awardings": [],
        "spoiler": false,
        "locked": false,
        "author_flair_text": null,
        "visited": false,
        "removed_by": null,
        "distinguished": null,
        "subreddit_id": "t5_examples",
        "author_is_blocked": false,
        "link_flair_background_color": "",
        "id": "5v1z4l",
        "author": "HackerBot-1",
        "num_comments": 4349,
        "send_replies": true,
        "contest_mode": false,
        "author_flair_text_color": null,
        "permalink": "https://www.reddit.com/r/test/comments/1sys4r2/image_post/",
        "stickied": false,
        "url": "https://www.reddit.com/r/test/comments/1sys4r2/image_post/",
        "subreddit_subscribers": 41527,
        "created_utc": 1487557007.0,
        "num_crossposts": 0,
        "media": null,
        "is_video": false
      },
      {
        "subreddit": "test",
        "selftext": "https://www.reddit.com/r/test/comments/1sys4r2/image_post/",
        "author_fullname": "t2_exampleu",
        "saved": false,
        "gilded": 0,
        "clicked": false,
        "title": "Testing New Orchestrator\\nThis is a fully automated post from the new Python-Node.js bridge. High-quality stats collection enabled! #ai #lingerie",
        "link_flair_richtext": [],
        "subreddit_name_prefixed": "r/test",
        "hidden": false,
        "link_flair_css_class": null,
        "downs": 0,
        "thumbnail_height": 140,
        "hide_score": false,
        "media_metadata": {
          "ubj9be5h6cxg1": {
            "status": "valid",
            "e": "Image",
            "m": "image/jpg",
            "p": [
              {
                "y": 108,
                "x": 108,
                "u": "https://www.reddit.com/r/test/comments/1sys4r2/image_post/"
              },
              {
                "y": 216,
                "x": 216,
                "u": "https://www.reddit.com/r/test/comments/1sys4r2/image_post/"
              },
              "\u2026 (3 more items)"
            ],
            "s": {
              "y": 1024,
              "x": 1024,
              "u": "https://www.reddit.com/r/test/comments/1sys4r2/image_post/"
            },
            "id": "ubj9be5h6cxg1"
          }
        },
        "name": "t3_1sys4r2",
        "quarantine": false,
        "link_flair_text_color": "dark",
        "upvote_ratio": 1.0,
        "author_flair_background_color": null,
        "ups": 1,
        "total_awards_received": 0,
        "media_embed": {},
        "thumbnail_width": 140,
        "is_original_content": false,
        "secure_media": null,
        "is_reddit_media_domain": false,
        "is_meta": false,
        "category": null,
        "secure_media_embed": {},
        "link_flair_text": null,
        "score": 1,
        "is_created_from_ads_ui": false,
        "author_premium": false,
        "thumbnail": "https://www.reddit.com/r/test/comments/1sys4r2/image_post/",
        "edited": false,
        "author_flair_css_class": null,
        "author_flair_richtext": [],
        "gildings": {},
        "content_categories": null,
        "is_self": true,
        "created": 1777122812.0,
        "link_flair_type": "text",
        "removed_by_category": null,
        "author_flair_type": "text",
        "domain": "self.test",
        "allow_live_comments": false,
        "selftext_html": "<div>Example HTML content.</div>",
        "likes": null,
        "suggested_sort": null,
        "archived": false,
        "is_crosspostable": false,
        "pinned": false,
        "over_18": false,
        "all_awardings": [],
        "spoiler": false,
        "locked": false,
        "author_flair_text": null,
        "visited": false,
        "removed_by": null,
        "distinguished": null,
        "subreddit_id": "t5_examples",
        "author_is_blocked": false,
        "link_flair_background_color": "",
        "id": "1svbvn7",
        "author": "Familiar_Lynx_5955",
        "num_comments": 1,
        "send_replies": true,
        "contest_mode": false,
        "author_flair_text_color": null,
        "permalink": "https://www.reddit.com/r/test/comments/1sys4r2/image_post/",
        "stickied": false,
        "url": "https://www.reddit.com/r/test/comments/1sys4r2/image_post/",
        "subreddit_subscribers": 41527,
        "created_utc": 1777122812.0,
        "num_crossposts": 0,
        "media": null,
        "is_video": false
      },
      "\u2026 (23 more items)"
    ],
    "cursor": "t3_1sys4r2",
    "count": 25
  },
  "error": null,
  "timestamp": "2026-04-29T08:58:24.462042+00:00"
}