YouTube channel search

Search videos within a YouTube channel by keyword with optional pagination.

← All YouTube endpoints · Capability overview

GET/v1/youtube/channel-search

https://api.vee3.io/v1/youtube/channel-search

10 tokens

Search videos within a YouTube channel by keyword with optional pagination.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

search_youtube_channel

Parameters3 fields

channel_idstringRequired

YouTube channel id (for example UCJ5v_MCY6GNUBTO8-D3XoAg, not a URL).

max length 24

querystringRequired

Search keywords or phrase within the channel.

max length 512

cursorstringOptional

Pagination cursor from cursorNext.

max length 4096

Response18 fields

contentsarrayitems

16 fields

Matching video entries for the current page. Each entry includes a type field and nested video object.

typestring

Result entry type (for example video).

videoobject

14 fields

Video payload when type is video.

videoIdstring

Video id.

titlestring

Video title.

lengthSecondsinteger

Video duration in seconds.

publishedTimeTextstring

Human-readable publish age.

isLiveNowboolean

Whether the video is live.

badgesarrayitems

1 field

Video badges (for example CC, 4K).

badgestring

Badge label.

statsobject

1 field

View counts for the video.

viewsinteger

View count.

thumbnailsarrayitems

3 fields

Static thumbnail images at different sizes.

heightinteger

Image height in pixels.

widthinteger

Image width in pixels.

urlstring

Image URL.

descriptionSnippetstring

Short description excerpt for the video.

cursorNextstring

Cursor for the next page, when available.

HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, youtube_channel_not_found, youtube_not_configured, youtube_upstream_error

Example request

Python

import requests

url = "https://api.vee3.io/v1/youtube/channel-search"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "channel_id": "UCJ5v_MCY6GNUBTO8-D3XoAg",
    "query": "john cena"
}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Sample channel search results for john cena on the WWE channel.

wwe_john_cena_results.json

{
  "contents": [
    {
      "type": "video",
      "video": {
        "badges": [
          "CC"
        ],
        "descriptionSnippet": "Watch the legendary battles and story between John Cena and Batista, starting with a tag team match in 2002...",
        "isLiveNow": false,
        "lengthSeconds": 3725,
        "publishedTimeText": "1 day ago",
        "stats": {
          "views": 227139
        },
        "thumbnails": [
          {
            "height": 94,
            "url": "https://i.ytimg.com/vi/-m9HMCvo1Dg/hqdefault.jpg",
            "width": 168
          }
        ],
        "title": "John Cena vs. Batista – full rivalry history: WWE Playlist",
        "videoId": "-m9HMCvo1Dg"
      }
    }
  ],
  "cursorNext": "4qmFsgJ5EhhVQ0o1dl9NQ1k2R05VQlRPOC1EM1hvQWcaJkNCNFNCbk5sWVhKamFEQUJPQUZnQVdvQWVnTkhRalM0QVFBJTNEWglqb2huIGNlbmGaAilicm93c2UtZmVlZFVDSjV2X01DWTZHTlVCVE84LUQzWG9BZ3NlYXJjaA%3D%3D"
}