Reddit Subreddit Posts API

What is the Reddit Subreddit Posts API?

Pass a subreddit URL or r/name and get its posts as clean JSON. Choose sort (best/hot/new/top/rising) and, for top, a timeframe (hour/day/week/month/year/all). Each post includes title, text, author + authorFullname, Reddit's score + upvoteRatio, comment count, isVideo, flair, nsfw, and ISO publishedAt. scoreHidden, subscriberCount and thumbnail are null — the public feed page does not carry them. downs, totalAwardsReceived, and the upvotes twin of score are omitted. Reddit's feed returns about 24 posts per page; one call chains up to three pages to reach limit. Cursor pagination via nextCursor (the last returned post's t3_ name) + hasMore; an empty cursor is the first page. A subreddit that does not exist is 404 at 0 credits. A banned, private or quarantined subreddit is 404 with error.code SUBREDDIT_BANNED, SUBREDDIT_PRIVATE or SUBREDDIT_QUARANTINED (retryable false, 0 credits): Reddit does not show those communities to a logged-out reader. Flat 2 credits.

What you get

• Bulk list of subreddit posts with metadata
• Dates, URLs, and engagement fields when available
• Configurable result limit
• Ideal for monitoring and content pipelines

Fill in the parameters below and copy a ready-to-run request, or open the live Playground to run it against your account (no API key paste).

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_..."

Example response

{
  "success": true,
  "data": {
    "subreddit": "technology",
    "sort": "new",
    "timeframe": null,
    "totalReturned": 2,
    "nextCursor": "t3_1x9mzzt",
    "hasMore": true,
    "posts": [
      {
        "platform": "reddit",
        "id": "1x9q2lf",
        "name": "t3_1x9q2lf",
        "url": "https://www.reddit.com/r/technology/comments/1x9q2lf/greece_launches_daedalus_supercomputer_to_boost/",
        "title": "Greece launches Daedalus supercomputer to boost AI capabilities and reduce reliance on foreign infrastructure",
        "text": null,
        "subreddit": "technology",
        "author": "New-Ranger-8960",
        "authorFullname": "t2_1kg9u759hz",
        "score": 5,
        "upvoteRatio": 0.6666666666666666,
        "scoreHidden": null,
        "comments": 1,
        "subscriberCount": null,
        "isVideo": false,
        "publishedAt": "2026-10-19T07:09:28.000Z",
        "flair": "Artificial Intelligence",
        "nsfw": false,
        "thumbnail": null,
        "crosspostOf": null
      },
      {
        "platform": "reddit",
        "id": "1x9mzzt",
        "name": "t3_1x9mzzt",
        "url": "https://www.reddit.com/r/technology/comments/1x9mzzt/virtuix_partners_with_meta_to_sell_omni_one/",
        "title": "Virtuix Partners With Meta To Sell Omni One Treadmills Bundled With Quest Headsets",
        "text": null,
        "subreddit": "technology",
        "author": "Stukwan",
        "authorFullname": "t2_4m79xcva",
        "score": 10,
        "upvoteRatio": 0.8571428571428571,
        "scoreHidden": null,
        "comments": 3,
        "subscriberCount": null,
        "isVideo": false,
        "publishedAt": "2026-10-19T04:06:31.000Z",
        "flair": "Hardware",
        "nsfw": false,
        "thumbnail": null,
        "crosspostOf": null
      }
    ]
  }
}

Billing metadata is returned in response headers: X-Captapi-Credits (credits charged), X-Captapi-Cache (hit or miss), and X-Captapi-Request-Id (include it when contacting support). Where the response has a source field, it names the path that served the data: native, extended, cache or asr. Failed requests (4xx/5xx) are never charged. See the full list of error codes in the error reference.

Response structure

A successful call returns success and a data object with the following fields:

Parameters

Authentication: send your key as Authorization: Bearer capt_live_.... A typical call costs 2 credits. Pass cache=true for a free 24h cache hit; default is always fresh.

How it works

1. 1. Sign up — get 100 free credits, no card required.
2. 2. Create a key from your dashboard.
3. 3. Send one request to /v1/reddit/subreddit-posts and parse the JSON response.

Use cases

Frequently asked questions

More Reddit APIs