[← Back to tools]
youtube.search-shorts

Search YouTube Shorts by keyword: $0.001 per call, no API key

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

Youtube: get shorts search (web_v2) 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 youtube.search-shorts accepts as JSON input.

  • querystringRequired

    Keyword or phrase to search for.

  • cursorstringOptional

    Pagination token

  • sort_bystringOptional

    排序方式 | Sort by for Shorts

  • time_zonestringOptional

    Time zone

  • upload_timestringOptional

    上传时间过滤 | Upload time filter for Shorts

  • country_codestringOptional

    Country code

  • search_querystringRequired

    Search keyword

  • language_codestringOptional

    Language code

  • filter_mixed_contentbooleanOptional

    Filter mixed content (long videos), default True

Raw input JSON Schema
{
  "type": "object",
  "required": [
    "search_query",
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Keyword or phrase to search for."
    },
    "cursor": {
      "type": "string",
      "maxLength": 2000,
      "description": "Pagination token"
    },
    "sort_by": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "排序方式 | Sort by for Shorts"
    },
    "time_zone": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Time zone"
    },
    "upload_time": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "上传时间过滤 | Upload time filter for Shorts"
    },
    "country_code": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Country code"
    },
    "search_query": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Search keyword"
    },
    "language_code": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Language code"
    },
    "filter_mixed_content": {
      "type": "boolean",
      "description": "Filter mixed content (long videos), default True"
    }
  },
  "additionalProperties": false
}

Returns

Fields a successful youtube.search-shorts 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 youtube.search-shorts tool with this input: {"search_query":"Python编程","language_code":"en-US","country_code":"US","time_zone":"America/Los_Angeles","filter_mixed_content":true,"query":"Python编程"}
Start with $1 freeSee 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]