scraper
Back to API docs

Overview

  • Overview

APIs

  • POSTPost
  • POSTSearch

Reddit Post

1 credit

Get a Reddit post with its comments.

POST/api/v1/tools/reddit/post

Parameters

urlstringrequired

Full Reddit post URL (e.g. "https://www.reddit.com/r/programming/comments/abc123/...").

maxCommentsnumber

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

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. 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. Only present when truncation occurred.

metaobject

Request metadata

toolstring

Tool name (reddit-post)

creditsUsednumber

Credits consumed (1)

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
      }
    ],
    "count": 1,
    "totalComments": 187,
    "truncated": true
  },
  "meta": {
    "tool": "reddit-post",
    "creditsUsed": 1,
    "requestId": "req_abc123"
  }
}