scraper
Back to API docs

Overview

  • Overview

APIs

  • POSTPost
  • POSTSearch
  • POSTSubreddit
  • POSTUser Posts
  • POSTUser Comments
  • POSTCommunity

Reddit Subreddit

1 credit; 2 with comments

List posts from a subreddit feed, optionally with each post's comments.

POST/api/v1/tools/reddit/subreddit

Parameters

subredditstringrequired

Subreddit name, with or without the r/ prefix (e.g. "programming").

sortstring

Listing sort: hot, new, top, rising, relevance, or comments. Search-only sorts map onto hot for feeds. Defaults to hot.

timestring

Time window for top and controversial: hour, day, week, month, year, or all (default). A window narrower than "all" also filters the whole walk.

maxItemsnumber

Maximum number of posts to return. Above 100, further sorts and time windows are walked and deduplicated. Upper bound is determined by your plan. Defaults to 50.

includeNsfwboolean

Include over-18 posts. Defaults to true.

includeCommentsboolean

Also fetch each post's comment thread. Costs 2 credits instead of 1. Defaults to false.

maxCommentsPerPostnumber

Maximum comments per post when includeComments is true. Defaults to 50; at most 500. Upper bound is determined by your plan.

commentSortstring

Comment ordering: confidence (default), top, new, controversial, old, or qa.

expandCommentsboolean

Follow "load more comments" links so deep threads are complete. Defaults to false.

fieldsstring[]

Post fields to include. Defaults: id, author, title, text, score, createdAt, subreddit, numComments. Use ["*"] for every field, including flair, media, and moderation flags.

commentFieldsstring[]

Comment fields to include when includeComments is true. Defaults: id, author, text, score, createdAt, subreddit, parentId, linkId, depth, linkTitle. Use ["*"] for all fields.

Response Schema

dataobject

Subreddit feed result

postsobject[]

Posts in listing order. Fields depend on the fields parameter; defaults listed below.

commentsobject[]

Comments for every post when includeComments is true, in thread order; empty otherwise. Tie a comment to its post through linkId.

countnumber

Number of posts returned

truncatedboolean

True when the request budget stopped the walk or a thread expansion before everything asked for was fetched.

metaobject

Request metadata

toolstring

Tool name (reddit-subreddit)

creditsUsednumber

Credits consumed (1, or 2 with includeComments)

requestIdstring

Unique request ID

Request

curl -X POST https://scraper.run/api/v1/tools/reddit/subreddit \
  -H "Authorization: Bearer sc_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "subreddit": "programming",
    "sort": "top",
    "time": "week",
    "maxItems": 25
  }'

Response Example

{
  "data": {
    "posts": [
      {
        "id": "abc123",
        "author": "dev_user",
        "title": "What programming language should I learn in 2026?",
        "text": "Looking for recommendations on which language to pick up next...",
        "score": 342,
        "createdAt": "2026-04-08T15:30:00.000Z",
        "subreddit": "programming",
        "numComments": 187
      },
      {
        "id": "def456",
        "author": "sys_admin",
        "title": "We migrated 400 services to Rust. Here is what broke.",
        "text": "A write-up of our two-year migration...",
        "score": 1280,
        "createdAt": "2026-04-08T12:05:00.000Z",
        "subreddit": "programming",
        "numComments": 412
      }
    ],
    "comments": [],
    "count": 2,
    "truncated": false
  },
  "meta": {
    "tool": "reddit-subreddit",
    "creditsUsed": 1,
    "requestId": "req_abc123"
  }
}