xiaohongshu.search

Search Xiaohongshu notes: pay per use, no API key

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

Search public Xiaohongshu (RedNote) notes by keyword 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 xiaohongshu.search accepts as JSON input.

pageintegerOptional
One-based results page number.
querystringRequired
Keyword or phrase to search for in Xiaohongshu notes.
note_type"all" | "video" | "image"Optional
Limit results to all notes, video notes, or image notes.
sort_type"general" | "popularity_descending" | "time_descending"Optional
Sort order: general relevance, popularity, or newest first.

Raw input JSON Schema

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "One-based results page number."
    },
    "query": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Keyword or phrase to search for in Xiaohongshu notes."
    },
    "note_type": {
      "enum": [
        "all",
        "video",
        "image"
      ],
      "type": "string",
      "description": "Limit results to all notes, video notes, or image notes."
    },
    "sort_type": {
      "enum": [
        "general",
        "popularity_descending",
        "time_descending"
      ],
      "type": "string",
      "description": "Sort order: general relevance, popularity, or newest first."
    }
  },
  "additionalProperties": false
}

Returns

Fields a successful xiaohongshu.search 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 xiaohongshu.search tool with this input: {"query":"coffee","page":1,"sort_type":"general","note_type":"all"}

Start with $1 free See pricing

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]