[← Back to tools]
youtube.search-suggestions

YouTube search suggestions by partial 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 search suggestions (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-suggestions accepts as JSON input.

  • querystringRequired

    Search keyword

  • regionstringOptional

    Region code (e.g., US, SG, CN, JP)

  • languagestringOptional

    Language code (e.g., en, zh-cn, ja)

Raw input JSON Schema
{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 500,
      "minLength": 1,
      "description": "Search keyword"
    },
    "region": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Region code (e.g., US, SG, CN, JP)"
    },
    "language": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Language code (e.g., en, zh-cn, ja)"
    }
  },
  "additionalProperties": false
}

Returns

Fields a successful youtube.search-suggestions 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-suggestions tool with this input: {"query":"Rick Astley","language":"en","region":"US"}
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]