[← Back to tools]
apify.reddit-posts

Get subreddit posts: pay per use, no API key

Use Apify from Claude, Claude Code, Cursor, ChatGPT, and other agents through one Cralo balance.

Fetch public posts from one subreddit using an Apify Reddit actor. Price is per post plus a small start fee (quoted from `limit`, max 1000).

Price and execution

Price
$0.00115
Pricing model
Fixed price per successful call
Execution class
fast

Limits

No additional limits are published for this tool.

Parameters

Fields apify.reddit-posts accepts as JSON input.

  • sort"hot" | "new" | "top" | "rising" | "relevance"Optional

    Reddit ordering for returned posts.

  • limitintegerOptional

    Maximum number of records to return (1 to 1000, default 10). Quoted price scales with this limit.

  • subredditstringRequired

    Subreddit name without the `r/` prefix.

  • time_filter"hour" | "day" | "week" | "month" | "year" | "all"Optional

    Time window applied to Reddit sorting and search.

Raw input JSON Schema
{
  "type": "object",
  "required": [
    "subreddit"
  ],
  "properties": {
    "sort": {
      "enum": [
        "hot",
        "new",
        "top",
        "rising",
        "relevance"
      ],
      "type": "string",
      "default": "hot",
      "description": "Reddit ordering for returned posts."
    },
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 1000,
      "minimum": 1,
      "description": "Maximum number of records to return (1 to 1000, default 10). Quoted price scales with this limit."
    },
    "subreddit": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_]+
quot;,
      "maxLength": 21,
      "minLength": 1,
      "description": "Subreddit name without the `r/` prefix."
    },
    "time_filter": {
      "enum": [
        "hour",
        "day",
        "week",
        "month",
        "year",
        "all"
      ],
      "type": "string",
      "default": "week",
      "description": "Time window applied to Reddit sorting and search."
    }
  },
  "additionalProperties": false
}

Returns

Fields a successful apify.reddit-posts call returns.

  • countintegerRequired
  • resultsarray of objectRequired
    • idstring | nullOptional
    • urlstring | nullOptional
    • bodystring | nullOptional
    • titlestring | nullOptional
    • upVotesnumber | nullOptional
    • dataTypestring | nullOptional
    • usernamestring | nullOptional
    • createdAtstring | nullOptional
    • communityNamestring | nullOptional
    • numberOfCommentsnumber | nullOptional
  • retrieved_atstring (date-time)Required
  • provider_request_idstring | nullRequired
Raw output JSON Schema
{
  "type": "object",
  "required": [
    "results",
    "count",
    "provider_request_id",
    "retrieved_at"
  ],
  "properties": {
    "count": {
      "type": "integer",
      "minimum": 0
    },
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": [
              "string",
              "null"
            ]
          },
          "url": {
            "type": [
              "string",
              "null"
            ],
            "format": "uri"
          },
          "body": {
            "type": [
              "string",
              "null"
            ]
          },
          "title": {
            "type": [
              "string",
              "null"
            ]
          },
          "upVotes": {
            "type": [
              "number",
              "null"
            ]
          },
          "dataType": {
            "type": [
              "string",
              "null"
            ]
          },
          "username": {
            "type": [
              "string",
              "null"
            ]
          },
          "createdAt": {
            "type": [
              "string",
              "null"
            ]
          },
          "communityName": {
            "type": [
              "string",
              "null"
            ]
          },
          "numberOfComments": {
            "type": [
              "number",
              "null"
            ],
            "minimum": 0
          }
        },
        "additionalProperties": true
      },
      "maxItems": 1000
    },
    "retrieved_at": {
      "type": "string",
      "format": "date-time"
    },
    "provider_request_id": {
      "type": [
        "string",
        "null"
      ]
    }
  },
  "additionalProperties": false
}

Run this tool

Copy this instruction to your agent to set up Cralo and call this tool with the example input.

Set up Cralo by following https://cralo.ai/SKILL.md, then call the apify.reddit-posts tool with this input: {"subreddit":"programming","sort":"hot","time_filter":"week","limit":1}
Start with $1 freeSee pricing

Safety notes

Side Effect
read_only
Public Sources Only
Yes
Authenticated Content
No

How this compares to using Apify directly

You do not need a separate Apify account or subscription for this call. Cralo uses one prepaid balance across all tools and shows the per-call price before you run the command.

Related tools

[Browse all tools]