Reddit: posts, comments, users, and subreddits.
Search Reddit posts by keyword. Use cursor to paginate or maxItems for a one-shot bulk pull (mutually exclusive). sort is relevance (default), hot, top, new, or comments.
Price: $0.001 per item
Minimum charge: $0.01 per request (10 items)
Your current plan discount applies to the total. The minimum applies once per request, even when fewer items are returned. maxItems limits requested results; it does not lower the minimum billable count.
javascriptSuccessful request
3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24200OKtrueBad request
Insufficient balance
Not found
GET /reddit/search/post?keyword=text HTTP/1.1
Host: api.pullbay.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"requestId": "3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24",
"status": 200,
"message": "OK",
"success": true,
"data": [
{
"type": "post",
"id": "1qclvp3",
"title": "Is learning JavaScript still a good decision in 2026?",
"text": "",
"textHTML": "",
"url": "/r/learnprogramming/comments/1qclvp3/is_learning_javascript_still_a_good_decision_in/",
"created": 1768393294,
"editedAt": false,
"score": 11,
"upvotes": 11,
"downvotes": 0,
"upvoteRatio": 0.68,
"numComments": 51,
"viewCount": 1,
"goldCount": 0,
"numCrossposts": 0,
"isLocked": false,
"isStickied": false,
"isArchived": false,
"isOriginalContent": false,
"isCrosspostable": false,
"isNSFW": false,
"isSpoiler": false,
"isMediaOnly": false,
"isSponsored": false,
"isMeta": false,
"isGildable": false,
"isScoreHidden": false,
"contestMode": false,
"hidden": false,
"sendReplies": true,
"author": {
"id": "t2_1w72",
"username": "spez",
"isBlocked": false,
"isDeleted": false
},
"subreddit": {
"id": "t5_2fwo",
"name": "programming",
"prefixedName": "r/programming",
"type": "public"
},
"flair": {},
"thumbnail": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"preview": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"awards": [
{
"ANY_ADDITIONAL_PROPERTY": "anything"
}
],
"flairs": [
{
"ANY_ADDITIONAL_PROPERTY": "anything"
}
],
"gallery": [
{
"ANY_ADDITIONAL_PROPERTY": "anything"
}
],
"crosspostParents": [
{
"ANY_ADDITIONAL_PROPERTY": "anything"
}
]
}
],
"pagination": {
"page": 1,
"hasNextPage": null,
"cursor": null,
"offset": null
},
"pricing": {
"currency": "USD",
"amountCharged": "0.010000",
"billableItems": 10
}
}Returns a single Reddit post by its ID.
Price: $0.005 per item
Minimum charge: $0.005 per request (1 item)
Your current plan discount applies to the total. The minimum applies once per request, even when fewer items are returned. maxItems limits requested results; it does not lower the minimum billable count.
1qclvp3Successful request
3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24200OKtrueBad request
Insufficient balance
Not found
GET /reddit/post/{id} HTTP/1.1
Host: api.pullbay.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"requestId": "3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24",
"status": 200,
"message": "OK",
"success": true,
"data": [
{
"type": "post",
"id": "1qclvp3",
"title": "Is learning JavaScript still a good decision in 2026?",
"text": "",
"textHTML": "",
"url": "/r/learnprogramming/comments/1qclvp3/is_learning_javascript_still_a_good_decision_in/",
"created": 1768393294,
"editedAt": false,
"score": 11,
"upvotes": 11,
"downvotes": 0,
"upvoteRatio": 0.68,
"numComments": 51,
"viewCount": 1,
"goldCount": 0,
"numCrossposts": 0,
"isLocked": false,
"isStickied": false,
"isArchived": false,
"isOriginalContent": false,
"isCrosspostable": false,
"isNSFW": false,
"isSpoiler": false,
"isMediaOnly": false,
"isSponsored": false,
"isMeta": false,
"isGildable": false,
"isScoreHidden": false,
"contestMode": false,
"hidden": false,
"sendReplies": true,
"author": {
"id": "t2_1w72",
"username": "spez",
"isBlocked": false,
"isDeleted": false
},
"subreddit": {
"id": "t5_2fwo",
"name": "programming",
"prefixedName": "r/programming",
"type": "public"
},
"flair": {},
"thumbnail": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"preview": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"awards": [
{
"ANY_ADDITIONAL_PROPERTY": "anything"
}
],
"flairs": [
{
"ANY_ADDITIONAL_PROPERTY": "anything"
}
],
"gallery": [
{
"ANY_ADDITIONAL_PROPERTY": "anything"
}
],
"crosspostParents": [
{
"ANY_ADDITIONAL_PROPERTY": "anything"
}
]
}
],
"pricing": {
"currency": "USD",
"amountCharged": "0.005000",
"billableItems": 1
}
}Returns the top-level comment tree for a Reddit post.
Price: $0.001 per item
Minimum charge: $0.01 per request (10 items)
Your current plan discount applies to the total. The minimum applies once per request, even when fewer items are returned. maxItems limits requested results; it does not lower the minimum billable count.
1qclvp3Successful request
3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24200OKtrueBad request
Insufficient balance
Not found
GET /reddit/post/{id}/comments HTTP/1.1
Host: api.pullbay.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"requestId": "3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24",
"status": 200,
"message": "OK",
"success": true,
"data": [
{
"type": "comment",
"id": "ojb40kw",
"postId": "t3_1t0jood",
"parentId": "t3_1t0jood",
"body": "That was Rich Greenfield from LightShed.",
"bodyHTML": "",
"url": "/r/redditstock/comments/1t0jood/.../ojb40kw/",
"createdAt": 1777638722,
"editedAt": false,
"score": 24,
"upvotes": 24,
"downvotes": 0,
"goldCount": 0,
"totalAwardsReceived": 0,
"controversiality": 0,
"isLocked": false,
"isStickied": false,
"isArchived": false,
"isSaved": false,
"isScoreHidden": false,
"isCollapsed": false,
"noFollow": false,
"sendReplies": true,
"hasReplies": false,
"author": {
"id": "t2_1w72",
"username": "spez",
"isBlocked": false,
"isDeleted": false
},
"subreddit": {
"id": "t5_2fwo",
"name": "programming",
"prefixedName": "r/programming",
"type": "public"
},
"awards": [
{
"ANY_ADDITIONAL_PROPERTY": "anything"
}
]
}
],
"pricing": {
"currency": "USD",
"amountCharged": "0.010000",
"billableItems": 10
}
}Returns replies to a specific comment on a Reddit post.
Price: $0.001 per item
Minimum charge: $0.01 per request (10 items)
Your current plan discount applies to the total. The minimum applies once per request, even when fewer items are returned. maxItems limits requested results; it does not lower the minimum billable count.
1qclvp3nzj5dkeSuccessful request
3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24200OKtrueBad request
Insufficient balance
Not found
GET /reddit/post/{id}/comments/{commentId}/replies HTTP/1.1
Host: api.pullbay.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"requestId": "3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24",
"status": 200,
"message": "OK",
"success": true,
"data": [
{
"type": "comment",
"id": "ojb40kw",
"postId": "t3_1t0jood",
"parentId": "t3_1t0jood",
"body": "That was Rich Greenfield from LightShed.",
"bodyHTML": "",
"url": "/r/redditstock/comments/1t0jood/.../ojb40kw/",
"createdAt": 1777638722,
"editedAt": false,
"score": 24,
"upvotes": 24,
"downvotes": 0,
"goldCount": 0,
"totalAwardsReceived": 0,
"controversiality": 0,
"isLocked": false,
"isStickied": false,
"isArchived": false,
"isSaved": false,
"isScoreHidden": false,
"isCollapsed": false,
"noFollow": false,
"sendReplies": true,
"hasReplies": false,
"author": {
"id": "t2_1w72",
"username": "spez",
"isBlocked": false,
"isDeleted": false
},
"subreddit": {
"id": "t5_2fwo",
"name": "programming",
"prefixedName": "r/programming",
"type": "public"
},
"awards": [
{
"ANY_ADDITIONAL_PROPERTY": "anything"
}
]
}
],
"pricing": {
"currency": "USD",
"amountCharged": "0.010000",
"billableItems": 10
}
}Returns a Reddit user profile by username (without u/).
Price: $0.005 per item
Minimum charge: $0.005 per request (1 item)
Your current plan discount applies to the total. The minimum applies once per request, even when fewer items are returned. maxItems limits requested results; it does not lower the minimum billable count.
spezSuccessful request
3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24200OKtrueBad request
Insufficient balance
Not found
GET /reddit/user/{username} HTTP/1.1
Host: api.pullbay.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"requestId": "3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24",
"status": 200,
"message": "OK",
"success": true,
"data": [
{
"type": "user",
"id": "1w72",
"name": "spez",
"title": "spez",
"description": "Reddit CEO",
"createdAt": 1118030400,
"iconImage": "https://styles.redditmedia.com/t5_3k30p/styles/profileIcon_uj015iwx9s7g1.png",
"snoovatarImage": "",
"bannerImage": "https://b.thumbs.redditmedia.com/KWeEpVxXOGLoloMbM0IxGt9EiKPXizpwFgcSeWqtpZM.png",
"awarderKarma": 0,
"postKarma": 182496,
"commentKarma": 755311,
"totalKarma": 937807,
"hasVerifiedEmail": true,
"over18": false
}
],
"pricing": {
"currency": "USD",
"amountCharged": "0.005000",
"billableItems": 1
}
}Returns posts submitted by a Reddit user. Use cursor to paginate or maxItems for a one-shot bulk pull (mutually exclusive).
Price: $0.001 per item
Minimum charge: $0.01 per request (10 items)
Your current plan discount applies to the total. The minimum applies once per request, even when fewer items are returned. maxItems limits requested results; it does not lower the minimum billable count.
spezSuccessful request
3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24200OKtrueBad request
Insufficient balance
Not found
GET /reddit/user/{username}/posts HTTP/1.1
Host: api.pullbay.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"requestId": "3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24",
"status": 200,
"message": "OK",
"success": true,
"data": [
{
"type": "post",
"id": "1qclvp3",
"title": "Is learning JavaScript still a good decision in 2026?",
"text": "",
"textHTML": "",
"url": "/r/learnprogramming/comments/1qclvp3/is_learning_javascript_still_a_good_decision_in/",
"created": 1768393294,
"editedAt": false,
"score": 11,
"upvotes": 11,
"downvotes": 0,
"upvoteRatio": 0.68,
"numComments": 51,
"viewCount": 1,
"goldCount": 0,
"numCrossposts": 0,
"isLocked": false,
"isStickied": false,
"isArchived": false,
"isOriginalContent": false,
"isCrosspostable": false,
"isNSFW": false,
"isSpoiler": false,
"isMediaOnly": false,
"isSponsored": false,
"isMeta": false,
"isGildable": false,
"isScoreHidden": false,
"contestMode": false,
"hidden": false,
"sendReplies": true,
"author": {
"id": "t2_1w72",
"username": "spez",
"isBlocked": false,
"isDeleted": false
},
"subreddit": {
"id": "t5_2fwo",
"name": "programming",
"prefixedName": "r/programming",
"type": "public"
},
"flair": {},
"thumbnail": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"preview": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"awards": [
{
"ANY_ADDITIONAL_PROPERTY": "anything"
}
],
"flairs": [
{
"ANY_ADDITIONAL_PROPERTY": "anything"
}
],
"gallery": [
{
"ANY_ADDITIONAL_PROPERTY": "anything"
}
],
"crosspostParents": [
{
"ANY_ADDITIONAL_PROPERTY": "anything"
}
]
}
],
"pagination": {
"page": 1,
"hasNextPage": null,
"cursor": null,
"offset": null
},
"pricing": {
"currency": "USD",
"amountCharged": "0.010000",
"billableItems": 10
}
}Returns comments authored by a Reddit user. Use cursor to paginate or maxItems for a one-shot bulk pull (mutually exclusive).
Price: $0.001 per item
Minimum charge: $0.01 per request (10 items)
Your current plan discount applies to the total. The minimum applies once per request, even when fewer items are returned. maxItems limits requested results; it does not lower the minimum billable count.
spezSuccessful request
3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24200OKtrueBad request
Insufficient balance
Not found
GET /reddit/user/{username}/comments HTTP/1.1
Host: api.pullbay.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"requestId": "3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24",
"status": 200,
"message": "OK",
"success": true,
"data": [
{
"type": "comment",
"id": "ojb40kw",
"postId": "t3_1t0jood",
"parentId": "t3_1t0jood",
"body": "That was Rich Greenfield from LightShed.",
"bodyHTML": "",
"url": "/r/redditstock/comments/1t0jood/.../ojb40kw/",
"createdAt": 1777638722,
"editedAt": false,
"score": 24,
"upvotes": 24,
"downvotes": 0,
"goldCount": 0,
"totalAwardsReceived": 0,
"controversiality": 0,
"isLocked": false,
"isStickied": false,
"isArchived": false,
"isSaved": false,
"isScoreHidden": false,
"isCollapsed": false,
"noFollow": false,
"sendReplies": true,
"hasReplies": false,
"author": {
"id": "t2_1w72",
"username": "spez",
"isBlocked": false,
"isDeleted": false
},
"subreddit": {
"id": "t5_2fwo",
"name": "programming",
"prefixedName": "r/programming",
"type": "public"
},
"awards": [
{
"ANY_ADDITIONAL_PROPERTY": "anything"
}
]
}
],
"pagination": {
"page": 1,
"hasNextPage": null,
"cursor": null,
"offset": null
},
"pricing": {
"currency": "USD",
"amountCharged": "0.010000",
"billableItems": 10
}
}Returns a subreddit profile by its name (without r/).
Price: $0.005 per item
Minimum charge: $0.005 per request (1 item)
Your current plan discount applies to the total. The minimum applies once per request, even when fewer items are returned. maxItems limits requested results; it does not lower the minimum billable count.
programmingSuccessful request
3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24200OKtrueBad request
Insufficient balance
Not found
GET /reddit/subreddit/{name} HTTP/1.1
Host: api.pullbay.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"requestId": "3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24",
"status": 200,
"message": "OK",
"success": true,
"data": [
{
"type": "subreddit",
"id": "2fwo",
"name": "programming",
"prefixedName": "r/programming",
"title": "programming",
"subType": "public",
"description": "/r/programming is a reddit for discussion and news about computer programming.",
"descriptionHtml": "",
"publicDescription": "Computer Programming",
"publicDescriptionHtml": "",
"submitText": "",
"submitTextHtml": "text",
"submissionType": "link",
"advertiserCategory": "Technology",
"language": "en",
"url": "/r/programming/",
"headerTitle": "",
"iconImage": "",
"iconSize": [
1
],
"bannerImage": "",
"bannerBackgroundImage": "",
"bannerSize": [
1
],
"headerImage": "https://b.thumbs.redditmedia.com/2rTE46grzsr-Ll3Q.png",
"headerSize": [
120,
40
],
"primaryColor": "#002b36",
"keyColor": "",
"createdAt": 1141150769,
"subscribers": 6873180,
"commentScoreHideMins": 0,
"notificationLevel": "text",
"suggestedCommentSort": "text",
"userFlairEnabled": true,
"linkFlairEnabled": true,
"wikiEnabled": true,
"emojisEnabled": false,
"spoilersEnabled": true,
"allowImages": false,
"allowVideos": false,
"allowGalleries": false,
"allowPolls": false,
"allowPredictions": false,
"allowTalks": false,
"allowDiscovery": true,
"isCrosspostable": false,
"publicTraffic": false,
"showMediaPreview": true,
"showMedia": false,
"collapseDeletedComments": false,
"shouldArchivePosts": false,
"canAssignUserFlair": false,
"canAssignLinkFlair": false,
"restrictCommenting": false,
"restrictPosting": true,
"communityReviewed": true,
"flairPosition": "right",
"linkFlairPosition": "right"
}
],
"pricing": {
"currency": "USD",
"amountCharged": "0.005000",
"billableItems": 1
}
}Returns posts from a subreddit. Use cursor to paginate or maxItems for a one-shot bulk pull (mutually exclusive).
Price: $0.001 per item
Minimum charge: $0.01 per request (10 items)
Your current plan discount applies to the total. The minimum applies once per request, even when fewer items are returned. maxItems limits requested results; it does not lower the minimum billable count.
programmingSuccessful request
3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24200OKtrueBad request
Insufficient balance
Not found
GET /reddit/subreddit/{name}/posts HTTP/1.1
Host: api.pullbay.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"requestId": "3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24",
"status": 200,
"message": "OK",
"success": true,
"data": [
{
"type": "post",
"id": "1qclvp3",
"title": "Is learning JavaScript still a good decision in 2026?",
"text": "",
"textHTML": "",
"url": "/r/learnprogramming/comments/1qclvp3/is_learning_javascript_still_a_good_decision_in/",
"created": 1768393294,
"editedAt": false,
"score": 11,
"upvotes": 11,
"downvotes": 0,
"upvoteRatio": 0.68,
"numComments": 51,
"viewCount": 1,
"goldCount": 0,
"numCrossposts": 0,
"isLocked": false,
"isStickied": false,
"isArchived": false,
"isOriginalContent": false,
"isCrosspostable": false,
"isNSFW": false,
"isSpoiler": false,
"isMediaOnly": false,
"isSponsored": false,
"isMeta": false,
"isGildable": false,
"isScoreHidden": false,
"contestMode": false,
"hidden": false,
"sendReplies": true,
"author": {
"id": "t2_1w72",
"username": "spez",
"isBlocked": false,
"isDeleted": false
},
"subreddit": {
"id": "t5_2fwo",
"name": "programming",
"prefixedName": "r/programming",
"type": "public"
},
"flair": {},
"thumbnail": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"preview": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"awards": [
{
"ANY_ADDITIONAL_PROPERTY": "anything"
}
],
"flairs": [
{
"ANY_ADDITIONAL_PROPERTY": "anything"
}
],
"gallery": [
{
"ANY_ADDITIONAL_PROPERTY": "anything"
}
],
"crosspostParents": [
{
"ANY_ADDITIONAL_PROPERTY": "anything"
}
]
}
],
"pagination": {
"page": 1,
"hasNextPage": null,
"cursor": null,
"offset": null
},
"pricing": {
"currency": "USD",
"amountCharged": "0.010000",
"billableItems": 10
}
}Last updated