Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mindcase.co/llms.txt

Use this file to discover all available pages before exploring further.

$2.9 / 1k results Extract Reddit posts and comments — by URL (subreddit / post / user) or search keyword

​
Endpoint

POST /api/v1/agents/reddit/posts/run

​
Parameters

​
inputs
array
required
List · One per line. You can input Reddit URLs (subreddits, posts, users) or search keywords (e.g. ‘gpt5’, ‘r/wallstreetbets’).
​
maxPosts
integer
default:50
Number · Maximum posts per URL/search. Use 0 for all.
​
skipComments
boolean
default:false
Toggle · Don’t fetch any comments at all (post-only mode).
​
maxComments
integer
default:10
Number · Comments per post. Use 0 for all, or toggle Skip Comments above for none.
​
sortBy
string
default:"top"
Dropdown · Sort order for posts.Options: top, new, hotLegend: top = Top, new = Newest, hot = Hot
​
timeRange
string
default:"all"
Dropdown · Reddit’s search only supports preset time windows — pick one. (No custom date ranges.)Options: all, year, month, week, day, hourLegend: all = All time, year = Past year, month = Past month, week = Past week, day = Past 24 hours, hour = Past hour

​
Response columns

FieldDisplay nameType
redditUrlReddit URLurl
typeTypetext
titleTitletext
bodyBodytext
communityCommunitytext
authorAuthortext
postedPostedtext
upVotesUp Votesnumber
upVoteRatioUp Vote Ratiopercentage
commentsCommentsnumber
repliesRepliesnumber
isVideoIs Videoboolean
isAdIs Adboolean
nsfwNSFWboolean
flairFlairtext
categoryCategorytext
thumbnailThumbnailurl
imagesImagestext
videoVideourl
externalLinkExternal Linkurl

​
Example

curl -X POST https://api.mindcase.co/api/v1/agents/reddit/posts/run \
  -H "Authorization: Bearer mk_live_abc123def456" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "urls": [
      {
        "url": "https://www.reddit.com/r/memes/comments/xfn9vg/rmemes_meme_quiz_2/"
      },
      {
        "url": "https://www.reddit.com/r/wallstreetbets/comments/l8rf4k/times_square_right_now/"
      }
    ],
    "sortBy": "top",
    "maxResults": 12,
    "maxPosts": 2,
    "maxComments": 4
  }
}'

​
Example response

Response
{
  "job_id": "job_7f3a2b1c",
  "status": "completed",
  "data": [
    {
      "redditUrl": "https://www.reddit.com/r/memes/comments/xfn9vg/rmemes_meme_quiz_2/",
      "type": "Post",
      "title": "R/MEMES MEME QUIZ #2",
      "body": "Thumbnail: default\n",
      "community": "r/memes",
      "author": "elch3w",
      "posted": "2022-12-23T23:15:07.000Z",
      "upVotes": 622849,
      "upVoteRatio": 0.88,
      "comments": 4893,
      "replies": null,
      "isVideo": false,
      "isAd": false,
      "nsfw": false,
      "flair": null,
      "category": null,
      "thumbnail": "default",
      "images": [],
      "video": null,
      "externalLink": "https://reddit.com/r/memes/predictions?tournament=tnmt-3cad1a25-79e9-4d47-b2e1-85b8a3471421"
    }
  ]
}