Reddit Community API
Collect Reddit community posts with sorting, time-range and pagination options.
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
Request Headers
| Parameters | Parameter value | Type | Description |
|---|---|---|---|
| Content-Type | application/json | string | Data format |
| Authorization | Bearer xxx | string | Authorization Token |
Collection takes up to approximately 75 seconds. Set your client timeout to 90 seconds.
Request Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
| target | Yes | string | Target URL, supported ID or search keyword for this operation. |
| options | No | object | Optional collection settings, described below. |
options Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
| sort | No | string | Result ordering. Supported values are listed below. Values: [“hot”, “new”, “top”, “rising”, “controversial”] |
| t | No | string | Time range for the selected listing or search sort. Values: [“hour”, “day”, “week”, “month”, “year”, “all”] |
| limit | No | integer | Number of items per page. Default: 25 Minimum: 1 Maximum: 100 |
| after | No | string | null | Pass pagination.after from the previous response unchanged. |
| includeCommunity | No | boolean | Include 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
| Field | Type | Description |
|---|---|---|
| code | integer | Status code; 0 indicates success. |
| message | string | Response message; ok on success. |
| pointCost | number | Points charged for this request. |
| data | object | Collected data, with fields described below. |
| meta | object | Request identifier and duration in milliseconds. |
| billing | object | Charged units, unit price and billing rule version. |
data Fields
| Field | Type | Description |
|---|---|---|
| type | string | Result type. |
| subreddit | string | Subreddit name without r/. |
| sort | string | Result ordering. Supported values are listed below. |
| community | object | null | Community |
| posts | object[] | Collected posts. |
| count | number | Number of result items. |
| pagination | object | Continuation cursor and whether more results are available. |
data.community Fields
| Field | Type | Description |
|---|---|---|
| url | string | Content URL. |
| name | string | Name |
| desc | string | null | Desc |
| weeklyVisitors | number | null | Weekly visitors |
| weeklyContributions | number | null | Weekly contributions |
| subredditId | string | null | Subreddit id |
data.posts[] Fields
| Field | Type | Description |
|---|---|---|
| title | string | null | Title |
| captionText | string | Caption text |
| publishedAt | object | null | Publication time. |
| likes | number | null | Like count. |
| commentsCount | number | null | Platform-reported comment total; not the number billed. |
| video | object | null | Video |
| redditPostId | string | Reddit post id |
| id36 | string | null | Id36 |
| url | string | null | Content URL. |
| linkUrl | string | null | Link url |
| domain | string | null | Domain |
| subreddit | string | null | Subreddit name without r/. |
| flair | string | null | Flair |
| ups | number | null | Ups |
| upvoteRatio | number | null | Upvote ratio |
| numCrossposts | number | null | Num crossposts |
| editedAt | object | null | Edited at |
| isSelf | boolean | Is self |
| isVideo | boolean | Is video |
| over18 | boolean | Over18 |
| spoiler | boolean | Spoiler |
| stickied | boolean | Stickied |
| locked | boolean | Locked |
| archived | boolean | Archived |
| distinguished | string | null | Distinguished |
| postHint | string | null | Post hint |
| thumbnail | string | null | Thumbnail |
| previewImage | string | null | Preview image |
| redditVideo | object | null | Reddit video |
| gallery | object[] | Gallery |
| content | string | null | Content text; may be null for records without text. |
| poster | object | Poster |
data.posts[].publishedAt Fields
| Field | Type | Description |
|---|---|---|
| text | string | null | Text value. |
| value | number | null | Parsed value. |
data.posts[].video Fields
| Field | Type | Description |
|---|---|---|
| src | string | null | Src |
| preview | string | null | Preview |
| poster | string | null | Poster |
data.posts[].editedAt Fields
| Field | Type | Description |
|---|---|---|
| text | string | null | Text value. |
| value | number | null | Parsed value. |
data.posts[].redditVideo Fields
| Field | Type | Description |
|---|---|---|
| hlsUrl | string | Hls url |
| fallbackUrl | string | Fallback url |
| dashUrl | string | Dash url |
| width | number | Width |
| height | number | Height |
| duration | number | Duration |
data.posts[].gallery[] Fields
| Field | Type | Description |
|---|---|---|
| url | string | Content URL. |
| width | number | null | Width |
| height | number | null | Height |
| caption | string | null | Caption |
data.posts[].poster Fields
| Field | Type | Description |
|---|---|---|
| nickname | string | null | Author display name. |
| profileUrl | string | null | Author profile URL. |
| id | string | null | Record identifier. |
data.pagination Fields
| Field | Type | Description |
|---|---|---|
| after | string | null | Pass pagination.after from the previous response unchanged. |
| hasMore | boolean | Whether more results are available. |
Request Example
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.
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.

