Reddit · Guide

How to run a Reddit search

TL;DR
To run a Reddit search, sign up for a free Captapi key, then send one GET request to /v1/reddit/search with your input. You get clean JSON back in seconds for ~10 credits (0.4/result) per call — no OAuth, scraping or platform SDKs. Search Reddit programmatically and page results with nextCursor.

How to run a Reddit search (step by step)

  1. 1

    Get a free API key

    Create a free Captapi account (100 credits, no card) and generate an API key from the dashboard.

  2. 2

    Call the Reddit Search API

    Send an authenticated GET request to /v1/reddit/search with your input. No OAuth, no scraping setup.

  3. 3

    Read the JSON response

    Parse the clean JSON response. Pass cache=true for a free 24h cache hit; default is always fresh.

Code example

curl "https://api.captapi.com/v1/reddit/search?q=james%20webb%20telescope" \
  -H "Authorization: Bearer capt_live_..."
# or: -H "x-api-key: capt_live_..."

What the response looks like

{
  "success": true,
  "data": {
    "query": "james webb telescope",
    "totalReturned": 5,
    "nextCursor": "t3_1oqvn0t",
    "hasMore": true,
    "results": [
      {
        "platform": "reddit",
        "id": "vuhfl9",
        "url": "https://www.reddit.com/r/nosleep/comments/vuhfl9/the_james_webb_telescope_discovered_something/",
        "title": "The James Webb Telescope discovered something terrifying in deep space",
        "text": "I work for NASA as an astronomer, and there are certain things we keep hidden from the public. No, the Earth isn't flat, and aliens don't control the government. Fuck, I wish those were the case, as the truth is much, much worse.\n\nIn 1993, the Hubble Space Telescope saw a star disappear. It didn't go supernova, or die naturally, it simply went dark, over the span of a few minutes. This star was already too faint to see with the naked eye, and ground-based telescopes had trouble picking it out from among the surrounding stars, so the event wasn't widely known to the public. At the time, we thought the most likely explanation was that a cloud of interstellar dust had drifted between Earth and the star, occluding it from view. It was noted and mostly forgotten about.\n\nIn 2007, two more stars vanished. Due to the circumstances of this event, this was much more concerning. The two stars in question were part of a binary system, orbiting each other at a fairly close distance. If a cloud of interstellar dust was the culprit again, they would have both seemed to disappear simultaneously, or very close to it. Instead, both stars faded individually over a period of minutes, separated by a span of about 8 hours. This binary system was also about 15 light-years closer to Earth than the star that had previously disappeared in 1993.\n\nAfter carefully reviewing millions of Hubble images, two more stars were identified which had 'gone out', in the years 1995 and 2002. These were all in the same stellar neighborhood, only a handful of light-years from each other. The only conclusion we could draw was that some unknown influence, traveling close to the speed of light, was shrouding (or destroying) these stars. Unfortunately, the Hubble wasn't sensitive enough to tell us any more than that.\n\nThe James Webb Space Telescope first came online a few months ago. Although official channels will tell you that it's still undergoing testing, we have been actively collecting data since early February. One of the first things we did was to aim the telescope at the regions of space occupied by the vanished stars. If they were being blocked by dust clouds (a hope some of us still held onto), the increased sensitivity of the JWST may have been able to see through them and confirm that the stars were still there. Unfortunately, we had no such luck. The first 3 stars that had disappeared were still completely dark. Gravitational wave detectors, though, soon found something odd. In all cases, not only were the stellar masses still present, but the amount of mass had actually increased. More sensitive observations had also detected a type of 'string', or 'web' stretching through space connecting these now-invisible stars.\n\nWhen we trained the telescope on the binary system that had vanished in 2007, which was the nearest point at which this phenomenon had so far been observed, there was finally enough ambient EM spectrum radiation left to try a mass spectrometer reading. If you're not aware, mass spectrometry is an incredibly useful process, where by measuring the patterns of light wavelengths emitted or reflected by an object, we can learn tons of useful information, such as its temperature, speed and direction of movement, and chemical composition. The readings we got from the binary stars didn't make any sense, though. First of all, they were cold - almost as cold as the surrounding interstellar medium. Whatever had happened to these stars had snuffed them out completely, or somehow prevented their light from escaping. What was truly puzzling, however, were the emission lines returned by the mass spectrometer. Several familiar elements, such as Hydrogen, Carbon, Nitrogen, Oxygen, and Magnesium were identified, but these were few and far between. Most of the readings didn't correspond to any known chemical elements, and even seemed to defy what we knew about the physics of light, matter, and chemistry. This massive, star-spanning structure was primarily composed of materials that we didn't even have names for, and may not even have been matter as we understand it.\n\nSpeculation ran rampant. Obviously, such a thing couldn't be a natural phenomenon. Finally, we had proof of extraterrestrial life! But what was this thing we had discovered, and for what purpose was it being built? The leading hypothesis was that we were looking at a series of Dyson Shells - massive solar collectors built to completely envelop stars, in order to capture 100% of their energy output. Such a concept had been envisioned in the early 20th century, as a potential source of energy for an interstellar civilization. Ever since then, the idea had found its way into popular science fiction. The construction of these massive structures had actually been theorized to be one of the first signs of intelligent extraterrestrial life that we may someday detect. It seemed that day was today.\n\nThe theory still didn't explain everything, though. First of all, there was the impossible speed with which the stars were covered. Constructing a Dyson shell from scratch in a matter of minutes was beyond even the wildest speculations of scientists and sci-fi writers. Then there were the mysterious 'filaments' that connected the shells over distances of light-years. No one had any idea what purpose these could serve, or how they could even be built.\n\nEveryone at NASA was fascinated by this mystery. In hindsight, we may have been better off if we had never discovered the truth.\n\nLess than a month ago, the JWST detected a series of unusual energy bursts emanating from interstellar space. These were occurring at the very edge of a star system approximately 12 light-years from the binary system that vanished in 2007. As we focused the telescope on this system, we soon determined that these were not natural phenomena either. The energy signatures, which were still flashing intermittently, matched what would be expected from thermonuclear and antimatter - based explosions, along with several other types of energies that we couldn't identify. These explosions, although still not visible to the naked eye on Earth from that distance, were absolutely tremendous in magnitude - easily billions of times more powerful than any nuke that humanity could conceivably build.  \n\n\nAfter experimenting with the telescope's settings, we were able to get a clearer picture of what was going on: The tip of one of the interstellar 'filaments' that linked the Dyson system was passing through the Oort Cloud of the distant star system, approaching its sun. And whoever lived there was fighting back. Their weapons were able to slow the thing's advance, shattering, breaking off, and vaporizing planet-sized chunks of the object, but it seemed to be rebuilding itself almost as fast as it was being destroyed. After less than a week, the explosions stopped. It seems that they had run out of ammunition. In the void between stars, we knew that these things traveled at nearly the speed of light, but as we watched it approach the inner star system, its pace slowed as it swelled in size, preparing to devour the system's star.\n\nWe quickly trained the telescope's mirrors on the doomed sun. We were about to watch whatever this thing was blot out another star, but in real time. We all held our breath as we watched the projected image of the main sequence star, slightly larger than our own sun. At first, nothing seemed to be happening, but soon a small shadow appeared on the edge of the luminous orb, soon followed by another shadow, and then a third. The shadows began to converge, forming a strange yet somehow familiar pattern as they blocked out the star's light.\n\n\"What... are those?\" One of my colleagues gasped. \"They almost look like...\" she paused, as if afraid to say the next word for fear of ridicule. I, however, had no such hesitancy.\n\n\"Leaves,\" I said, my voice monotone. The situation was far too incredible to express any emotional reaction, even that of pure shock. \"They look like leaves.\"\n\nWe watched as, over a period of minutes, a web of shadowy outlines, matching the familiar shapes of oblong leaves and thin vines, proceeded to blot out the remaining light from the distant star.\n\nBy that point, everyone in the room had realized the truth. The phenomenon we had been tracking for so many years wasn't some hyper-advanced alien megastructure. Hydrogen, Carbon, Nitrogen, Oxygen, and Magnesium, some of the few familiar elements we had detected? They were all components of chlorophyll.\n\nIt was a plant. An enormous plant that spanned across light-years. And, much like terrestrial plants, it sought out light to fuel itself. The filaments connecting the stars across interstellar space were stems - branches. It would grow in the direction of the nearest stars it sensed, completely enveloping them and then moving on. Any life inhabiting planets orbiting those stars would be left to freeze to death, or perhaps even worse, it was possible that the plant would devour those planets to add to its mass as well. \n\nEveryone was silent as the telescope continued to gather data. Eventually, after what seemed like an eternity, a young astronomer spoke up from the far end of the room, addressing our supervisor.\n\n\"Sir, we've begun to detect the formation of another tendril, leaving the system. Its vector is...\" he gulped. He didn't need to say any more, but he did anyway. \"It's heading directly for our sun.\"\n\n\"How much time do we have?\" the supervisor replied grimly.\n\n\"Judging by the time lag, distance, relativistic properties, and previously observed speeds of this... thing, I'd estimate no more than twenty-seven years, sir.\"\n\nTwenty-seven years. We had just watched this galactic weed overwhelm a civilization that was, at the very least, thousands of years ahead of us technologically, and we had less than three decades.\n\nI'll probably be found and silenced for posting this. But I don't care. I have to tell someone. I can't keep this a secret any longer. When the sun turns black and the world begins to freeze, at least you'll have some idea of what's going on, small comfort it may be.",
        "subreddit": "nosleep",
        "author": "Phonecloth",
        "upvotes": 12460,
        "comments": 1292,
        "publishedAt": "2022-07-08T18:30:31+00:00",
        "flair": null,
        "nsfw": false,
        "thumbnail": null
      },
      {
        "platform": "reddit",
        "id": "vxdrjs",
        "url": "https://www.reddit.com/r/pics/comments/vxdrjs/the_first_fullcolor_images_from_the_james_webb/",
        "title": "The first full-color images from the James Webb Space Telescope [OC]",
        "text": null,
        "subreddit": "pics",
        "author": "nasa",
        "upvotes": 130251,
        "comments": 2884,
        "publishedAt": "2022-07-12T15:21:41+00:00",
        "flair": null,
        "nsfw": false,
        "thumbnail": "https://a.thumbs.redditmedia.com/8LtDCR8118gXbX6gnY-wfOrhxH3QRQdYchWQ2mtpeG0.jpg"
      },
      {
        "platform": "reddit",
        "id": "1ucll2e",
        "url": "https://www.reddit.com/r/worldnews/comments/1ucll2e/james_webb_telescope_detects_galaxykilling_wind/",
        "title": "James Webb telescope detects 'galaxy-killing wind' near the dawn of time",
        "text": null,
        "subreddit": "worldnews",
        "author": "shdw_fght",
        "upvotes": 1467,
        "comments": 162,
        "publishedAt": "2026-06-22T14:08:15+00:00",
        "flair": null,
        "nsfw": false,
        "thumbnail": "https://external-preview.redd.it/MvcbMbmZOw99iMdDsy1JbsvZKf_5VGs-WQ1y5lrYGwo.jpeg?width=140&height=78&auto=webp&s=ff7d6360b316c1006ac4c27398dfc41df784e772"
      },
      {
        "platform": "reddit",
        "id": "1uoc2iy",
        "url": "https://www.reddit.com/r/space/comments/1uoc2iy/james_webb_telescope_may_have_discovered_a/",
        "title": "James Webb telescope may have discovered a ... never-before-seen [molecule] on Pluto and Titan",
        "text": null,
        "subreddit": "space",
        "author": "peterabbit456",
        "upvotes": 4008,
        "comments": 194,
        "publishedAt": "2026-07-05T20:06:51+00:00",
        "flair": null,
        "nsfw": false,
        "thumbnail": "https://external-preview.redd.it/UFDmgLQduMBtzlbjTNKShcfzcP1R7CqbdRhuulAMObQ.jpeg?width=140&height=78&auto=webp&s=238b494e2a39e0cc407a149711ec10f3263622e5"
      },
      {
        "platform": "reddit",
        "id": "1oqvn0t",
        "url": "https://www.reddit.com/r/askastronomy/comments/1oqvn0t/james_webbs_5_strangest_discoveries_and_one_of/",
        "title": "James Webb’s 5 strangest discoveries… and one of them completely breaks our current cosmology.",
        "text": "Hey everyone,  \nI’ve been going down a rabbit hole recently about the James Webb Space Telescope, and some of the discoveries are honestly blowing my mind.\n\nI’m talking about things like:  \n• massive galaxies appearing way too early after the Big Bang  \n• structures that look too organized for such a young universe  \n• supermassive black holes that somehow grew insanely fast  \n• unexpected molecules detected in exoplanet atmospheres  \n• and infrared signals that still don’t have a solid explanation\n\nI’m really curious about your opinions on this:  \n**Are these just early interpretations that will be corrected later, or is Webb genuinely challenging parts of the standard cosmology model?**\n\nI figured this subreddit would have people who follow this kind of stuff closely.  \nWould love to hear what you think or if you have recommended sources.",
        "subreddit": "askastronomy",
        "author": "Green_Advantage_1240",
        "upvotes": 385,
        "comments": 39,
        "publishedAt": "2025-11-07T14:19:46+00:00",
        "flair": null,
        "nsfw": false,
        "thumbnail": null
      }
    ]
  }
}

Billing metadata (credits charged, cache hit/miss) is returned in the X-Captapi-Credits and X-Captapi-Cache response headers.

Request parameters

NameTypeRequiredDescription
qstring YesKeywords or search query (min 2 characters).
limitintegerNoMax items to return (default 25, max 200). Billed per result.
cursorstringNoPagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response.
cachebooleanNoSet true to serve from the 24h response cache. Default false — always fetch fresh data.

Frequently asked questions

What does the Reddit Search API do?

The Reddit Search API lets you search and return matching results from a public Reddit query using one GET request to /v1/reddit/search. It returns clean JSON — no OAuth or infrastructure setup required.

How many credits does the Reddit Search API cost?

At the default limit this endpoint costs 10 credits (0.4 per result). Billing scales with how many results you request. Pass cache=true to serve from the 24h shared cache (0 credits on hit); default is always fresh. Failed or empty results are never charged.

Do I need a Reddit API key or OAuth?

No. A single Captapi key works across every platform Captapi supports — YouTube, TikTok, Instagram, Facebook, Twitter/X, Reddit, Threads, Bluesky, Pinterest, LinkedIn, Rumble, Spotify, Kwai, and more. We handle proxies, rate limits, retries, and authentication for you.

Is the Reddit Search API suitable for production use?

Yes. It is a stable REST endpoint with predictable JSON and automatic retries. Pass cache=true to serve from the 24h shared cache (0 credits on hit); default is always fresh. Use it for analytics, monitoring, and content automation.

Ready to run a Reddit search?

Start free with 100 credits — no credit card required.

Get your free API key