API Description

Reddit Community API — Collect Reddit community posts with sorting, time-range and pagination options.

Authenticate with your Pangolinfo API Key to receive structured JSON data.

Request URL

POST https://scrapeapi.pangolinfo.com/api/v1/social/reddit-community

Request Headers

ParametersParameter valueTypeDescription
Content-Typeapplication/jsonstringData format
AuthorizationBearer xxxstringAuthorization Token

Collection takes up to approximately 75 seconds. Set your client timeout to 90 seconds.

Request Parameters

ParameterRequiredTypeDescription
targetYesstringTarget URL, supported ID or search keyword for this operation.
optionsNoobjectOptional collection settings, described below.

options Parameters

ParameterRequiredTypeDescription
sortNostringResult ordering. Supported values are listed below.
Values: [“hot”, “new”, “top”, “rising”, “controversial”]
tNostringTime range for the selected listing or search sort.
Values: [“hour”, “day”, “week”, “month”, “year”, “all”]
limitNointegerNumber of items per page.
Default: 25
Minimum: 1
Maximum: 100
afterNostring | nullPass pagination.after from the previous response unchanged.
includeCommunityNobooleanInclude the subreddit card. Default: true.

Only the request parameters listed on this page are used; other fields are ignored. Pass pagination cursors back unchanged, without encoding, decoding or conversion.

Each request collects one page. Continue with the returned cursor.

Response Fields

FieldTypeDescription
codeintegerStatus code; 0 indicates success.
messagestringResponse message; ok on success.
pointCostnumberPoints charged for this request.
dataobjectCollected data, with fields described below.
metaobjectRequest identifier and duration in milliseconds.
billingobjectCharged units, unit price and billing rule version.

data Fields

FieldTypeDescription
typestringResult type.
subredditstringSubreddit name without r/.
sortstringResult ordering. Supported values are listed below.
communityobject | nullCommunity
postsobject[]Collected posts.
countnumberNumber of result items.
paginationobjectContinuation cursor and whether more results are available.

data.community Fields

FieldTypeDescription
urlstringContent URL.
namestringName
descstring | nullDesc
weeklyVisitorsnumber | nullWeekly visitors
weeklyContributionsnumber | nullWeekly contributions
subredditIdstring | nullSubreddit id

data.posts[] Fields

FieldTypeDescription
titlestring | nullTitle
captionTextstringCaption text
publishedAtobject | nullPublication time.
likesnumber | nullLike count.
commentsCountnumber | nullPlatform-reported comment total; not the number billed.
videoobject | nullVideo
redditPostIdstringReddit post id
id36string | nullId36
urlstring | nullContent URL.
linkUrlstring | nullLink url
domainstring | nullDomain
subredditstring | nullSubreddit name without r/.
flairstring | nullFlair
upsnumber | nullUps
upvoteRationumber | nullUpvote ratio
numCrosspostsnumber | nullNum crossposts
editedAtobject | nullEdited at
isSelfbooleanIs self
isVideobooleanIs video
over18booleanOver18
spoilerbooleanSpoiler
stickiedbooleanStickied
lockedbooleanLocked
archivedbooleanArchived
distinguishedstring | nullDistinguished
postHintstring | nullPost hint
thumbnailstring | nullThumbnail
previewImagestring | nullPreview image
redditVideoobject | nullReddit video
galleryobject[]Gallery
contentstring | nullContent text; may be null for records without text.
posterobjectPoster

data.posts[].publishedAt Fields

FieldTypeDescription
textstring | nullText value.
valuenumber | nullParsed value.

data.posts[].video Fields

FieldTypeDescription
srcstring | nullSrc
previewstring | nullPreview
posterstring | nullPoster

data.posts[].editedAt Fields

FieldTypeDescription
textstring | nullText value.
valuenumber | nullParsed value.

data.posts[].redditVideo Fields

FieldTypeDescription
hlsUrlstringHls url
fallbackUrlstringFallback url
dashUrlstringDash url
widthnumberWidth
heightnumberHeight
durationnumberDuration

data.posts[].gallery[] Fields

FieldTypeDescription
urlstringContent URL.
widthnumber | nullWidth
heightnumber | nullHeight
captionstring | nullCaption

data.posts[].poster Fields

FieldTypeDescription
nicknamestring | nullAuthor display name.
profileUrlstring | nullAuthor profile URL.
idstring | nullRecord identifier.

data.pagination Fields

FieldTypeDescription
afterstring | nullPass pagination.after from the previous response unchanged.
hasMorebooleanWhether more results are available.

Request Example

curl --request POST \
  --url https://scrapeapi.pangolinfo.com/api/v1/social/reddit-community \
  --header 'Authorization: Bearer YOUR_PANGOLINFO_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "target": "https://www.reddit.com/r/programming/"
}'

Response Example

This excerpt shows the first item of each list. Long text and URLs are shortened; pointCost is the charge for the complete response. The playground contains the full schema.

{
  "code": 0,
  "message": "ok",
  "pointCost": 4.0,
  "data": {
    "type": "community",
    "subreddit": "programming",
    "sort": "hot",
    "community": {
      "url": "https://www.reddit.com/r/programming/",
      "name": "programming",
      "desc": "Computer Programming",
      "weeklyVisitors": 215999,
      "weeklyContributions": 1608,
      "subredditId": "t5_2fwo"
    },
    "posts": [
      {
        "title": "openssh on musl linux has been letting people into password-less accounts since 2016",
        "captionText": "",
        "publishedAt": {
          "text": "2026-11-05T14:04:10.000Z",
          "value": 1793887450000
        },
        "likes": 531,
        "commentsCount": 74,
        "video": null,
        "redditPostId": "t3_1xojg3s",
        "id36": "1xojg3s",
        "url": "https://www.reddit.com/r/programming/comments/1xojg3s/openssh_on_musl_linux_has_been_letting_people/",
        "linkUrl": "https://sshhole.com/",
        "domain": "sshhole.com",
        "subreddit": "programming",
        "flair": null,
        "ups": 531,
        "upvoteRatio": 0.95,
        "numCrossposts": 1,
        "editedAt": {
          "text": null,
          "value": null
        },
        "isSelf": false,
        "isVideo": false,
        "over18": false,
        "spoiler": false,
        "stickied": false,
        "locked": false,
        "archived": false,
        "distinguished": null,
        "postHint": null,
        "thumbnail": null,
        "previewImage": null,
        "redditVideo": null,
        "gallery": [],
        "content": null,
        "poster": {
          "nickname": "ThisMachineIs4",
          "profileUrl": "https://www.reddit.com/user/ThisMachineIs4/",
          "id": "t2_cra0r"
        }
      }
    ],
    "count": 5,
    "pagination": {
      "after": null,
      "hasMore": true
    }
  },
  "meta": {
    "requestId": "pg-audit-r1-reddit-community-1793954309070149600",
    "durationMs": 4092
  },
  "billing": {
    "unitPrice": 0.8,
    "ruleVersion": "social-primary-v2",
    "billedCount": 5,
    "pointCost": 4.0
  }
}

Points Usage

0.8 points per primary result.

Empty results and failed requests are not charged. Duplicate IDs are counted once within a response. Separate calls and pages are billed separately. See Social Media Reviews API billing.

Try it