Reddit Post Details

reddit_post_details

Fetch detailed information about a Reddit post

Category: social•Timeout: 300s• Retryable

Input schema

POST this shape to /api/v1/tasks as the input field when creating a task in a group of type reddit_post_details.

{
  "type": "object",
  "properties": {
    "postUrl": {
      "type": "string",
      "description": "The full URL of the Reddit post",
      "pattern": "^https?://(www\\.)?reddit\\.com/r/[^/]+/comments/[^/]+",
      "examples": [
        "https://reddit.com/r/programming/comments/abc123/example_post"
      ],
      "x-ui": {
        "label": "Post URL",
        "placeholder": "https://reddit.com/r/subreddit/comments/...",
        "component": "input"
      }
    },
    "contentOnly": {
      "type": "boolean",
      "description": "Only return post data (omit author and subreddit)",
      "default": false,
      "enum": [
        false,
        true
      ],
      "x-ui": {
        "label": "Content Only",
        "placeholder": "Include author and subreddit",
        "component": "select",
        "options": [
          {
            "value": false,
            "label": "Include author and subreddit"
          },
          {
            "value": true,
            "label": "Post only"
          }
        ]
      }
    }
  },
  "required": [
    "postUrl"
  ]
}

Output schema

Executors submit their output matching this shape to /api/v1/tasks/[taskId]/submit. Readers pull it back from task detail endpoints.

{
  "type": "object",
  "properties": {
    "post": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "Reddit post ID"
        },
        "title": {
          "type": "string",
          "description": "Post title"
        },
        "content": {
          "type": "string",
          "description": "Post content or selftext"
        },
        "score": {
          "type": "integer",
          "description": "Post score (upvotes - downvotes)"
        },
        "commentCount": {
          "type": "integer",
          "description": "Number of comments"
        },
        "awardCount": {
          "type": "integer",
          "description": "Number of awards"
        },
        "createdAt": {
          "type": "string",
          "format": "date-time",
          "description": "Post creation timestamp"
        },
        "url": {
          "type": "string",
          "description": "Full URL of the post"
        }
      },
      "required": [
        "id",
        "title",
        "score",
        "commentCount"
      ]
    },
    "author": {
      "type": "object",
      "properties": {
        "username": {
          "type": "string",
          "description": "Reddit username"
        },
        "karma": {
          "type": "integer",
          "description": "Total karma points"
        },
        "postKarma": {
          "type": "integer",
          "description": "Post karma points"
        },
        "commentKarma": {
          "type": "integer",
          "description": "Comment karma points"
        },
        "createdAt": {
          "type": "string",
          "format": "date-time",
          "description": "Account creation timestamp"
        }
      },
      "required": [
        "username"
      ]
    },
    "subreddit": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "Subreddit name without r/ prefix"
        },
        "subscribers": {
          "type": "integer",
          "description": "Number of subscribers"
        },
        "online": {
          "type": "integer",
          "description": "Number of users currently online"
        },
        "weeklyVisitors": {
          "type": "integer",
          "description": "Number of weekly visitors"
        },
        "weeklyContributions": {
          "type": "integer",
          "description": "Number of weekly contributions"
        },
        "description": {
          "type": "string",
          "description": "Subreddit description"
        }
      },
      "required": [
        "name"
      ]
    }
  },
  "required": [
    "post"
  ]
}

Ready to run Reddit Post Details?

Create a project, approve an executor, and push your first reddit_post_details task.

Get started