youtube.search

Search YouTube: pay per use, no API key

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

Search public YouTube videos, channels, or playlists through TikHub.

Price and execution

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

Limits

No additional limits are published for this tool.

Parameters

Fields youtube.search accepts as JSON input.

type"video" | "channel" | "playlist" | "movie"Optional
YouTube search result type.
querystringRequired
Keyword or phrase to search for in YouTube.
cursorstringOptional
Opaque pagination cursor returned by a previous response; omit for the first page.
sort_bystringOptional
Optional TikHub sort key for the search.
durationstringOptional
Optional duration filter such as `short` or `long`.
upload_datestringOptional
Optional upload-date filter such as `today` or `week`.

Raw input JSON Schema

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "type": {
      "enum": [
        "video",
        "channel",
        "playlist",
        "movie"
      ],
      "type": "string",
      "default": "video",
      "description": "YouTube search result type."
    },
    "query": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Keyword or phrase to search for in YouTube."
    },
    "cursor": {
      "type": "string",
      "maxLength": 2000,
      "description": "Opaque pagination cursor returned by a previous response; omit for the first page."
    },
    "sort_by": {
      "type": "string",
      "maxLength": 40,
      "description": "Optional TikHub sort key for the search."
    },
    "duration": {
      "type": "string",
      "maxLength": 40,
      "description": "Optional duration filter such as `short` or `long`."
    },
    "upload_date": {
      "type": "string",
      "maxLength": 40,
      "description": "Optional upload-date filter such as `today` or `week`."
    }
  },
  "additionalProperties": false
}

Returns

Fields a successful youtube.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 youtube.search tool with this input: {"query":"coffee","type":"video"}

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]