Reddit Post

1 credit

Get a Reddit post with its comments.

POST/api/v1/tools/reddit/post

Parameters

urlstringrequired

Reddit post URL, redd.it short link, t3_ full name, or bare post ID (for example, "abc123").

maxCommentsnumber

Maximum number of comments to return. Must be a positive integer. Defaults to 200. Upper bound is determined by your plan.

commentSortstring

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

expandCommentsboolean

Follow "load more comments" links so deep threads are complete. Defaults to false. Costs 2 credits instead of 1.

fieldsstring[]

Fields to include per comment. Omit for defaults: id, author, text, createdAt, score, parentId. Use ["*"] for all fields. The post wrapper is always returned.

Response Schema

dataobject

Reddit post result

postobject

Post metadata

commentsobject[]

Array of comment objects in thread order (a parent always precedes its replies). Fields depend on the fields parameter. Default fields: id, author, text, createdAt, score, parentId.

countnumber

Number of comments returned

totalCommentsnumber | null

Total comment count reported by Reddit

truncatedboolean

True if more comments exist than were returned, or expansion stopped at the request budget. Only present when truncation occurred.

metaobject

Request metadata

toolstring

Tool name (reddit-post)

creditsUsednumber

Credits consumed (1, or 2 with expandComments)

requestIdstring

Unique request ID

Request

curl -X POST https://scraper.run/api/v1/tools/reddit/post \
  -H "Authorization: Bearer sc_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.reddit.com/r/programming/comments/abc123/example_post/",
    "maxComments": 50
  }'

Response Example

{
  "data": {
    "post": {
      "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...",
      "createdAt": "2026-04-08T15:30:00.000Z",
      "url": "https://reddit.com/r/programming/comments/abc123/what_programming_language/",
      "score": 342,
      "upvoteRatio": 0.94,
      "numComments": 187
    },
    "comments": [
      {
        "id": "xyz789",
        "parentId": "abc123",
        "author": "rust_fan",
        "text": "Rust has a steep learning curve but it is worth it for systems programming.",
        "createdAt": "2026-04-08T16:10:00.000Z",
        "score": 89
      },
      {
        "id": "uvw456",
        "parentId": "xyz789",
        "author": "go_dev",
        "text": "Agreed, though Go gets you productive faster.",
        "createdAt": "2026-04-08T16:25:00.000Z",
        "score": 31
      }
    ],
    "count": 2,
    "totalComments": 187,
    "truncated": true
  },
  "meta": {
    "tool": "reddit-post",
    "creditsUsed": 1,
    "requestId": "req_abc123"
  }
}

curl -X POST https://scraper.run/api/v1/tools/reddit/post \

-H "Authorization: Bearer sc_live_..." \

-H "Content-Type: application/json" \

-d '{

"url": "https://www.reddit.com/r/programming/comments/abc123/example_post/",

"maxComments": 50

{

"data": {

"post": {

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

"createdAt": "2026-04-08T15:30:00.000Z",

"url": "https://reddit.com/r/programming/comments/abc123/what_programming_language/",

"score": 342,

"upvoteRatio": 0.94,

"numComments": 187

"comments": [

{

"id": "xyz789",

"parentId": "abc123",

"author": "rust_fan",

"text": "Rust has a steep learning curve but it is worth it for systems programming.",

"createdAt": "2026-04-08T16:10:00.000Z",

"score": 89

{

"id": "uvw456",

"parentId": "xyz789",

"author": "go_dev",

"text": "Agreed, though Go gets you productive faster.",

"createdAt": "2026-04-08T16:25:00.000Z",

"score": 31

}

"count": 2,

"totalComments": 187,

"truncated": true

"meta": {

"tool": "reddit-post",

"creditsUsed": 1,

"requestId": "req_abc123"

}