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.01 / post
Pricing model: Per post, billed on success
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"
            ]
          },
          "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 free See 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]