Reddit · Guide

How to get Reddit subreddit posts

TL;DR
To get Reddit subreddit posts, sign up for a free Captapi key, then send one GET request to /v1/reddit/subreddit-posts with your input. You get clean JSON back in seconds for 2 credits per call — no OAuth, scraping or platform SDKs. List Reddit subreddit posts with full metadata per item and cursor pagination (nextCursor + hasMore).

How to get Reddit subreddit posts (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 Subreddit Posts API

    Send an authenticated GET request to /v1/reddit/subreddit-posts 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/subreddit-posts?url=https%3A%2F%2Fwww.reddit.com%2Fr%2Ftechnology%2F" \
  -H "Authorization: Bearer capt_live_..."
# or: -H "x-api-key: capt_live_..."

What the response looks like

{
  "success": true,
  "data": {
    "subreddit": "space",
    "totalReturned": 5,
    "nextCursor": "t3_1uz5c61",
    "hasMore": true,
    "posts": [
      {
        "platform": "reddit",
        "id": "1uzov27",
        "url": "https://www.reddit.com/r/space/comments/1uzov27/indias_first_privately_developed_orbital_rocket/",
        "title": "India's first privately developed orbital rocket, Vikram-1, reaches orbit on its debut flight",
        "text": null,
        "subreddit": "space",
        "author": "PlusCardiologist1799",
        "upvotes": 1151,
        "comments": 82,
        "publishedAt": "2026-07-18T07:04:51+00:00",
        "flair": null,
        "nsfw": false,
        "thumbnail": "https://external-preview.redd.it/ZsMGBF3jLW0ruZn7BHgqQMATfU14coAWySn-Hw3MvuE.jpeg?width=140&height=78&auto=webp&s=da0ca3471cff272906a18e07294f367aff1be5f9"
      },
      {
        "platform": "reddit",
        "id": "1uzogx7",
        "url": "https://www.reddit.com/r/space/comments/1uzogx7/vikram1_indias_first_private_space_rocket_by/",
        "title": "Vikram-1: India's first private space rocket by Skyroot to carry diamond flower",
        "text": null,
        "subreddit": "space",
        "author": "Yeahanu",
        "upvotes": 142,
        "comments": 10,
        "publishedAt": "2026-07-18T06:43:02+00:00",
        "flair": null,
        "nsfw": false,
        "thumbnail": "https://external-preview.redd.it/dqvtu4TvrJHqfPxEkexGWypEtpy_Nlk1_x2g1if3PWU.jpeg?width=140&height=78&auto=webp&s=9db79b3bbf5b02f51ef64917baf97eb90cf946b7"
      },
      {
        "platform": "reddit",
        "id": "1uzhhr4",
        "url": "https://www.reddit.com/r/space/comments/1uzhhr4/the_rise_and_fall_of_nasa/",
        "title": "The rise and fall of NASA",
        "text": null,
        "subreddit": "space",
        "author": "jeffsmith202",
        "upvotes": 0,
        "comments": 9,
        "publishedAt": "2026-07-18T00:50:18+00:00",
        "flair": null,
        "nsfw": false,
        "thumbnail": "https://external-preview.redd.it/vT5tVhZUWFii4x_na7hOshAJfkkhl7qVJElEdAoGfjE.jpeg?width=140&height=105&auto=webp&s=7e4fb403a796cea5c94a97cd8de5eb7c5a4a19ee"
      },
      {
        "platform": "reddit",
        "id": "1uzaoq3",
        "url": "https://www.reddit.com/r/space/comments/1uzaoq3/googlebacked_satellites_for_wildfire_detection/",
        "title": "Google-backed satellites for wildfire detection launch as smoke chokes US, Canada | The FireSat program can spot wildfires that other satellites miss.",
        "text": null,
        "subreddit": "space",
        "author": "FreeHugs23",
        "upvotes": 288,
        "comments": 24,
        "publishedAt": "2026-07-17T20:08:03+00:00",
        "flair": null,
        "nsfw": false,
        "thumbnail": "https://external-preview.redd.it/PD6_uR0U5hBIs4hbUOmD1O33Wx0FtSyYsexiswL8chE.png?width=140&height=78&auto=webp&s=56558e593f00d42b5cb7988c5bbe13c47e00682f"
      },
      {
        "platform": "reddit",
        "id": "1uz5c61",
        "url": "https://www.reddit.com/r/space/comments/1uz5c61/regarding_august_12_solar_eclipse_a_quick_safety/",
        "title": "Regarding August 12 Solar Eclipse: A Quick Safety Check for Your Eclipse Glasses",
        "text": "As the August 12 total solar eclipse approaches, I wanted to share a story. In 2024 I bought a set of solar eclipse glasses and found that the Sun looked way too bright for comfort.  By chance I tried them on inside, and I could see light bulbs, ceiling fans, etc.  I was pretty sure that wasn't supposed to happen.\n\nThat sent me down a rabbit hole researching how to tell whether the eclipse glasses were safe or not. I found three simple checks that anyone can do:\n\n**1) Check the markings:** Legit eclipse glasses should have printed information indicating compliance with the ISO 12312-2 standard.  This is not a guarantee, but it shows they did their homework.\n\n**2) Try them indoors first:** You should not be able to see ordinary objects or details in the room through properly rated eclipse glasses. It's normal to see the filament from a bright incandescent bulb or a really bright LED light.\n\n**3) Check the manufacturer:** The American Astronomical Society keeps a list of vetted solar eclipse glasses makers.\n\nIf you'd like to see these checks demonstrated, I put together a short video (please forgive my jumpiness, too much caffeine):\n\n[https://youtu.be/Q8aYrD32aAM](https://youtu.be/Q8aYrD32aAM)\n\nI hope all of you lucky enough to see the upcoming total solar eclipse has a wonderful time.  The 2024 experience was amazing.",
        "subreddit": "space",
        "author": "SillyEngineer",
        "upvotes": 116,
        "comments": 22,
        "publishedAt": "2026-07-17T16:54:59+00:00",
        "flair": "Discussion",
        "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
urlstring YesSubreddit URL, r/name, or bare name, e.g. r/technology. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
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 Subreddit Posts API do?

The Reddit Subreddit Posts API lets you list items in bulk with metadata from a public Reddit post using one GET request to /v1/reddit/subreddit-posts. It returns clean JSON — no OAuth or infrastructure setup required.

How many credits does the Reddit Subreddit Posts API cost?

Each successful call costs 2 credits. 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 Subreddit Posts 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 get Reddit subreddit posts?

Start free with 100 credits — no credit card required.

Get your free API key