[← Back to tools]
apify.reddit-search

Search Reddit: pay per use, no API key

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

Search public Reddit posts across Reddit or within one subreddit using an Apify actor run. 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-search 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.

  • querystringRequired

    Keyword or phrase to search for in Reddit posts.

  • subredditstringOptional

    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": [
    "query"
  ],
  "properties": {
    "sort": {
      "enum": [
        "hot",
        "new",
        "top",
        "rising",
        "relevance"
      ],
      "type": "string",
      "default": "relevance",
      "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."
    },
    "query": {
      "type": "string",
      "maxLength": 500,
      "minLength": 1,
      "description": "Keyword or phrase to search for in Reddit posts."
    },
    "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-search 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-search tool with this input: {"query":"OpenAI","subreddit":"programming","sort":"relevance","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]