# YouTube channel search

Takes keyword, continuation token and need format, all optional. Served by TikHub.

Purpose:
- Search YouTube channels
- Only returns channel-type search results (filters out videos, playlists, etc.)
- Supports pagination to get more channels

Parameters:
- keyword: Search keyword (required for first request)
- continuation_token: Pagination token (optional, for next page)
- need_format: Whether to format data (default true)
  - true: Return formatted structured data (recommended)
  - false: Return raw YouTube API structure (for debugging)

Returns:
When need_format=true:
- keyword: Search keyword
- channels: Channels list
  - channel_id: Channel ID (e.g., "UCjuNibFJ21MiSNpu8LZyV4w")
  - title: Channel name
  - handle: Channel custom handle (e.g., "@chaijing2023")
  - subscriber_count_text: Subscriber count text (e.g., "1.11M subscribers")
  - description: Channel description snippet
  - thumbnails: Thumbnail list (multiple sizes)
  - is_subscribed: Whether current user is subscribed to this channel (boolean)
  - canonical_url: Channel canonical URL path (e.g., "/@chaijing2023")
  - channel_url: Full channel URL (prefers custom URL)
- continuation_token: Next page pagination token
- has_more: Whether there are more channels
- total_count: Current page channel count

When need_format=false:
- keyword: Search keyword
- channels: Raw channelRenderer object list
- continuation_token: Next page pagination token
- has_more: Whether there are more channels
- total_count: Current page channel count

Usage Flow:
1. First request: Only pass keyword parameter
2. Get continuation_token from response
3. Next request: Pass continuation_token (keyword optional)
4. Repeat

- Tool ID: `tikhub/youtube-web-v2-search-channels`
- Variant: API v2
- Name in the catalog: Youtube, Search channels
- Provider: [TikHub](/providers/tikhub.md)
- Capability: [YouTube channels](/tools/youtube/channels.md)
- Price: $0.001 per call
- Authentication: an authorised Agentik workspace is required for execution, including zero-price tools.

## Pricing contract

The provider’s price, with no markup. Billed for measured usage.


```json
{
  "model": "per_call",
  "amountUsd": 0.001
}
```

Pricing source: [https://api.tikhub.io/api/v1/tikhub/user/get_all_endpoints_info](https://api.tikhub.io/api/v1/tikhub/user/get_all_endpoints_info). Official per-success route price USD 0.001; daily upstream discounts may reduce provider cost. No discount invented for the customer. 10/second.

Price verification date: 2026-10-05.

## Complete input schema


```json
{
  "type": "object",
  "properties": {
    "keyword": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 200
        },
        {
          "type": "null"
        }
      ],
      "description": "搜索关键词/Search keyword",
      "title": "Keyword"
    },
    "continuation_token": {
      "type": "string",
      "description": "分页token/Pagination token",
      "title": "Continuation Token"
    },
    "need_format": {
      "type": "boolean",
      "description": "是否格式化数据/Whether to format data",
      "default": true,
      "title": "Need Format"
    }
  },
  "additionalProperties": false
}
```

## Published example

This is the provider tool’s published example. Replace example values with the user’s requested inputs, respecting the schema; do not execute an example merely to test a connection.


```json
{
  "tool_id": "tikhub/youtube-web-v2-search-channels",
  "input": {
    "keyword": "Rick Astley",
    "need_format": true
  }
}
```

## Execute and retrieve

Inspect again before execution, explain the price and obtain the required authority. Use MCP run_tool or POST /v1/run with this tool ID, valid input and an idempotency key. Save the returned run ID and follow the actual state. If Agentik answers that the tool is temporarily unavailable, do not retry it blindly; use discovery to propose an alternative.

A partial or uncertain result can still have consumed provider resources. Consult [billing](/docs/billing.md), [idempotency](/docs/idempotency.md) and [asynchronous results](/docs/async.md).

[Provider documentation](https://api.tikhub.io/#/YouTube-Web-V2-API/search_channels_api_v1_youtube_web_v2_search_channels_get)

[REST inspection](https://api.agentik.cc/v1/tools/tikhub/youtube-web-v2-search-channels) · [OpenAPI](/openapi.json) · [Connection guide](/connect.md)

---

[HTML page](/providers/tikhub/youtube-web-v2-search-channels) · [Agent index](/llms.txt)