---
title: "Search within a YouTube channel"
method: GET
path: "/youtube/channel/{id}/search"
tags: ["YouTube"]
---

# Search within a YouTube channel

`GET /youtube/channel/{id}/search`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/youtube/channel/{id}/search`
- Auth: API key in header `x-api-key`

Searches the videos of one YouTube channel for the required `q`. `id` accepts a channel id, `@handle`, `/c` or `/user` path, or a full channel URL. Items carry the video id, title, URL, duration, view count, published text and thumbnail, and the response echoes the resolved `query`. Page with `continuation_token`.

## Path parameters

- `id` string, required

## Query parameters

- `q` string, required
- `continuation_token` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- YoutubeChannelSearchResponseDoc
  - `code` integer
  - `data` YoutubeChannelSearchResponseDataDoc
    - `channel_id` string: YouTube channel ID, starting with `UC`.
    - `channel_title` string: Channel name as shown on YouTube.
    - `channel_url` string: Link to the channel on YouTube.
    - `continuation_token` string: Token to pass in the next request to get the following page. Omitted on the last page.
    - `handle` string: Channel handle, starting with `@`.
    - `items` YoutubeSearchItem[]: Videos from the channel that match the search text.
      - `badges` string[]: Badge labels shown on the video, such as `HD` or `CC`.
      - `channel_id` string: YouTube channel ID, starting with `UC`.
      - `channel_thumbnail` string: URL of the publishing channel's avatar image.
      - `channel_title` string: Name of the channel that published the video or playlist.
      - `description_snippet` string: Short excerpt of the video or channel description shown in the results.
      - `duration` string: Video length as YouTube displays it, such as `12:34`.
      - `duration_seconds` integer: Video length in seconds.
      - `handle` string: Channel handle, starting with `@`. Set for channel results.
      - `is_live` boolean: Whether the video is a live stream.
      - `is_short` boolean: Whether the video is a YouTube Short.
      - `is_verified` boolean: Whether the channel carries a verified badge.
      - `playlist_id` string: YouTube playlist ID. Set for playlist results.
      - `position` integer: Position of the item on this page of results, starting at 1.
      - `published_text` string: Upload time as YouTube displays it, such as `2 days ago`.
      - `short_view_count` string: Abbreviated view count as YouTube displays it, such as `123K views`.
      - `subscriber_count` string: Subscriber count as YouTube displays it, such as `1.93M subscribers`.
      - `thumbnail` string: URL of the item's thumbnail image.
      - `title` string: Video or playlist title, or channel name.
      - `type` string: Kind of result: `video`, `channel` or `playlist`.
      - `url` string: Link to the video, channel or playlist on YouTube.
      - `video_count` string: Number of videos as YouTube displays it, such as `12 videos`. Set for channel and playlist results.
      - `video_id` string: YouTube video ID. Set for video results.
      - `view_count` string: View count as YouTube displays it, such as `123,456 views`.
    - `query` string: Search text that was run inside the channel.
    - `thumbnail` string: URL of the channel's avatar image.
  - `msg` string

## Other responses

- `400`: Missing or invalid parameters
- `429`: Rate limit exceeded
- `500`: Internal server error

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)