[← Back to tools]
reddit.search-posts

Search Reddit posts, communities, comments by keyword: $0.001 per call, no API key

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

Reddit: fetch dynamic search (app) through TikHub.

Price and execution

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

Limits

No additional limits are published for this tool.

Parameters

Fields reddit.search-posts accepts as JSON input.

  • sortstringOptional

    排序方式(仅适用于post/comment/media)/Sort method (only for post/comment/media): RELEVANCE(相关性), HOT(热门), TOP(最受欢迎), NEW(最新), COMMENTS(评论数,仅post)

  • afterstringOptional

    Pagination parameter

  • querystringRequired

    Search query

  • allow_nsfwstringOptional

    Allow NSFW content: 0, 1

  • time_rangestringOptional

    时间范围(仅适用于post/media)/Time range (only for post/media): all(所有时间), year(去年), month(上月), week(上周), day(今天), hour(过去1小时)

  • need_formatbooleanOptional

    Whether to clean and format the data

  • safe_searchstringOptional

    Safe search setting: unset, strict

  • search_typestringOptional

    搜索类型/Search type: post(帖子), community(社区), comment(评论), media(媒体), people(用户)

Raw input JSON Schema
{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "sort": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "排序方式(仅适用于post/comment/media)/Sort method (only for post/comment/media): RELEVANCE(相关性), HOT(热门), TOP(最受欢迎), NEW(最新), COMMENTS(评论数,仅post)"
    },
    "after": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Pagination parameter"
    },
    "query": {
      "type": "string",
      "maxLength": 500,
      "minLength": 1,
      "description": "Search query"
    },
    "allow_nsfw": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Allow NSFW content: 0, 1"
    },
    "time_range": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "时间范围(仅适用于post/media)/Time range (only for post/media): all(所有时间), year(去年), month(上月), week(上周), day(今天), hour(过去1小时)"
    },
    "need_format": {
      "type": "boolean",
      "description": "Whether to clean and format the data"
    },
    "safe_search": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Safe search setting: unset, strict"
    },
    "search_type": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "搜索类型/Search type: post(帖子), community(社区), comment(评论), media(媒体), people(用户)"
    }
  },
  "additionalProperties": false
}

Returns

Fields a successful reddit.search-posts call returns.

  • countintegerRequired
  • resultsanyRequired

    Raw TikHub payload. List endpoints usually nest rows under keys such as `itemList`.

  • 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": {
      "description": "Raw TikHub payload. List endpoints usually nest rows under keys such as `itemList`."
    },
    "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 reddit.search-posts tool with this input: {"query":"python programming","search_type":"post","sort":"RELEVANCE","time_range":"all","safe_search":"unset","allow_nsfw":"0","need_format":false}

Safety notes

Side Effect
read_only
Public Sources Only
Yes
Authenticated Content
No

How this compares to using TikHub directly

You do not need a separate TikHub 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]