# YouTube 검색

**API:** Data API

**Endpoint:** `GET /v1/beta/youtube/search`

**Tags:** YouTube Search

YouTube에서 동영상, 채널, 재생목록을 검색합니다. engine=youtube와 q는 필수입니다. 국가와 언어에는 gl과 hl을, 페이지네이션과 고급 필터에는 sp를 사용하세요.

### 가격 참고

- 과금 기준: 성공한 요청당 고정 원가 기준.
- 참고 요청 추정치: USD 0.0029.
- 참고 고객 배수: 1.0. 정산된 고객 금액에 다시 적용하지 마세요.

참고용 메타데이터일 뿐이며, 계정 견적이나 보장된 가격 또는 지출 한도가 아닙니다. 리소스 크레딧은 Felo 크레딧이 아닙니다. 최종 청구는 Felo 청구 기록을 따릅니다.

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `engine` | query | yes | string, enum: "youtube" | SearchApi 엔진 식별자입니다. 이 YouTube 엔드포인트에는 `youtube`를 사용하세요. |
| `gl` | query | no | string | 국가 코드(예: us, jp) |
| `hl` | query | no | string | 인터페이스 언어 |
| `q` | query | yes | string | 검색 쿼리입니다. 런타임과 업스트림 SearchApi에서 필요로 합니다. |
| `sp` | query | no | string | YouTube 필터 토큰(페이지네이션 또는 고급 필터) |

## Responses

### 200 — 성공 응답

Headers:
- `X-Request-Id` (string) — Felo 지원팀에 문의할 때 포함할 요청 식별자입니다.

**application/json**

Schema: `ResponseFc5Af1Fcba22_SearchResponse` (`#/components/schemas/ResponseFc5Af1Fcba22_SearchResponse`)

### 400 — 요청을 처리할 수 없습니다. 요청 매개변수를 확인하세요.

### 401 — 유효한 Felo API 키가 필요합니다.

### 402 — 청구 요건이 충족되지 않아 요청을 진행할 수 없습니다.

### 403 — 이 계정에는 이 작업을 수행할 권한이 없습니다.

### 429 — 요청 또는 지출 한도에 도달했습니다.

### 502 — 서비스가 요청을 완료할 수 없습니다.

### 503 — API 또는 청구 서비스를 일시적으로 사용할 수 없습니다.

### 504 — 요청을 처리하는 동안 서비스 시간이 초과되었습니다.

### default — 오류 응답. 업스트림 패스스루 응답은 공급자 형식을 사용할 수 있습니다.

**application/json**

Schema:

```json
{}
```

## Schema definitions

### ResponseFc5Af1Fcba22_Ad

`#/components/schemas/ResponseFc5Af1Fcba22_Ad`

```json
{
  "type": "object",
  "properties": {
    "position": {
      "type": "integer",
      "description": "검색 결과 내 위치"
    },
    "id": {
      "type": "string",
      "description": "동영상 광고의 동영상 ID"
    },
    "title": {
      "type": "string",
      "description": "광고 제목"
    },
    "link": {
      "type": "string",
      "description": "광고 링크"
    },
    "description": {
      "type": "string",
      "description": "광고 설명"
    },
    "website": {
      "type": "string",
      "description": "광고주 웹사이트 URL"
    },
    "channel": {
      "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_AdChannel"
    },
    "length": {
      "type": "string",
      "description": "동영상 광고의 동영상 길이"
    },
    "thumbnail": {
      "type": "string",
      "description": "광고 썸네일 URL"
    }
  }
}
```

### ResponseFc5Af1Fcba22_AdChannel

`#/components/schemas/ResponseFc5Af1Fcba22_AdChannel`

```json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "채널 ID"
    },
    "title": {
      "type": "string",
      "description": "채널 이름"
    },
    "link": {
      "type": "string",
      "description": "채널 링크"
    }
  }
}
```

### ResponseFc5Af1Fcba22_Channel

`#/components/schemas/ResponseFc5Af1Fcba22_Channel`

```json
{
  "type": "object",
  "properties": {
    "position": {
      "type": "integer",
      "description": "검색 결과 내 위치"
    },
    "id": {
      "type": "string",
      "description": "YouTube 채널 ID"
    },
    "title": {
      "type": "string",
      "description": "채널 이름"
    },
    "link": {
      "type": "string",
      "description": "채널 링크"
    },
    "description": {
      "type": "string",
      "description": "채널 설명"
    },
    "is_verified": {
      "type": "boolean",
      "description": "채널 인증 여부"
    },
    "video_count": {
      "type": "integer",
      "description": "동영상 수"
    },
    "subscribers": {
      "type": "integer",
      "description": "구독자 수"
    },
    "thumbnail": {
      "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_Thumbnail"
    }
  }
}
```

### ResponseFc5Af1Fcba22_FeaturedChannel

`#/components/schemas/ResponseFc5Af1Fcba22_FeaturedChannel`

```json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "추천 채널 ID"
    },
    "title": {
      "type": "string",
      "description": "추천 채널 제목"
    },
    "subtitle": {
      "type": "string",
      "description": "추천 채널 부제목"
    },
    "link": {
      "type": "string",
      "description": "추천 채널 링크"
    },
    "highlighted_video": {
      "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_HighlightedVideo"
    },
    "videos": {
      "type": "array",
      "description": "추천 채널 동영상",
      "items": {
        "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_FeaturedVideo"
      }
    }
  }
}
```

### ResponseFc5Af1Fcba22_FeaturedVideo

`#/components/schemas/ResponseFc5Af1Fcba22_FeaturedVideo`

```json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "동영상 ID"
    },
    "title": {
      "type": "string",
      "description": "동영상 제목"
    },
    "subtitle": {
      "type": "string",
      "description": "동영상 부제목"
    },
    "link": {
      "type": "string",
      "description": "동영상 링크"
    },
    "length": {
      "type": "string",
      "description": "동영상 길이"
    },
    "channel": {
      "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_FeaturedVideoChannel"
    },
    "thumbnail": {
      "type": "string",
      "description": "동영상 썸네일 URL"
    }
  }
}
```

### ResponseFc5Af1Fcba22_FeaturedVideoChannel

`#/components/schemas/ResponseFc5Af1Fcba22_FeaturedVideoChannel`

```json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "채널 ID"
    },
    "title": {
      "type": "string",
      "description": "채널 이름"
    },
    "link": {
      "type": "string",
      "description": "채널 링크"
    }
  }
}
```

### ResponseFc5Af1Fcba22_HighlightedVideo

`#/components/schemas/ResponseFc5Af1Fcba22_HighlightedVideo`

```json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "동영상 ID"
    },
    "title": {
      "type": "string",
      "description": "동영상 제목"
    },
    "subtitle": {
      "type": "string",
      "description": "동영상 부제목"
    },
    "link": {
      "type": "string",
      "description": "동영상 링크"
    },
    "length": {
      "type": "string",
      "description": "동영상 길이"
    }
  }
}
```

### ResponseFc5Af1Fcba22_KeyMoment

`#/components/schemas/ResponseFc5Af1Fcba22_KeyMoment`

```json
{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "description": "주요 모멘트 제목"
    },
    "start_seconds": {
      "type": "integer",
      "description": "모멘트 시작 시간(초)"
    },
    "thumbnail": {
      "type": "string",
      "description": "주요 모멘트 썸네일 URL"
    }
  }
}
```

### ResponseFc5Af1Fcba22_MetadataItems

`#/components/schemas/ResponseFc5Af1Fcba22_MetadataItems`

```json
{
  "type": "object",
  "properties": {
    "top": {
      "type": "array",
      "description": "상단 메타데이터 항목",
      "items": {
        "type": "string"
      }
    },
    "bottom": {
      "type": "array",
      "description": "하단 메타데이터 항목",
      "items": {
        "type": "string"
      }
    }
  }
}
```

### ResponseFc5Af1Fcba22_Movie

`#/components/schemas/ResponseFc5Af1Fcba22_Movie`

```json
{
  "type": "object",
  "properties": {
    "position": {
      "type": "integer",
      "description": "검색 결과 내 위치"
    },
    "id": {
      "type": "string",
      "description": "영화 동영상 ID"
    },
    "title": {
      "type": "string",
      "description": "영화 제목"
    },
    "link": {
      "type": "string",
      "description": "영화 링크"
    },
    "description": {
      "type": "string",
      "description": "영화 설명"
    },
    "channel": {
      "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_MovieChannel"
    },
    "length": {
      "type": "string",
      "description": "영화 길이"
    },
    "metadata_items": {
      "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_MetadataItems"
    },
    "badges": {
      "type": "array",
      "description": "영화 배지",
      "items": {
        "type": "string"
      }
    },
    "buttons": {
      "type": "array",
      "description": "작업 버튼",
      "items": {
        "type": "string"
      }
    },
    "thumbnail": {
      "type": "string",
      "description": "영화 썸네일 URL"
    }
  }
}
```

### ResponseFc5Af1Fcba22_MovieChannel

`#/components/schemas/ResponseFc5Af1Fcba22_MovieChannel`

```json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "채널 ID"
    },
    "title": {
      "type": "string",
      "description": "채널 이름"
    },
    "link": {
      "type": "string",
      "description": "채널 링크"
    },
    "is_verified": {
      "type": "boolean",
      "description": "채널 인증 여부"
    }
  }
}
```

### ResponseFc5Af1Fcba22_Pagination

`#/components/schemas/ResponseFc5Af1Fcba22_Pagination`

```json
{
  "type": "object",
  "properties": {
    "next_page_token": {
      "type": "string",
      "description": "다음 결과 페이지를 가져오는 토큰"
    }
  }
}
```

### ResponseFc5Af1Fcba22_PeopleAlsoSearchFor

`#/components/schemas/ResponseFc5Af1Fcba22_PeopleAlsoSearchFor`

```json
{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "추천 검색어"
    },
    "link": {
      "type": "string",
      "description": "검색을 수행하는 링크"
    },
    "thumbnail": {
      "type": "string",
      "description": "추천 항목의 썸네일"
    }
  }
}
```

### ResponseFc5Af1Fcba22_Playlist

`#/components/schemas/ResponseFc5Af1Fcba22_Playlist`

```json
{
  "type": "object",
  "properties": {
    "position": {
      "type": "integer",
      "description": "검색 결과 내 위치"
    },
    "id": {
      "type": "string",
      "description": "재생목록 ID"
    },
    "title": {
      "type": "string",
      "description": "재생목록 제목"
    },
    "link": {
      "type": "string",
      "description": "재생목록 링크"
    },
    "video_count": {
      "type": "integer",
      "description": "재생목록의 동영상 수"
    },
    "channel": {
      "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_PlaylistChannel"
    },
    "published_time": {
      "type": "string",
      "description": "게시 후 경과 시간"
    },
    "videos": {
      "type": "array",
      "description": "재생목록의 동영상",
      "items": {
        "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_PlaylistVideo"
      }
    },
    "thumbnail": {
      "type": "string",
      "description": "재생목록 썸네일 URL"
    }
  }
}
```

### ResponseFc5Af1Fcba22_PlaylistChannel

`#/components/schemas/ResponseFc5Af1Fcba22_PlaylistChannel`

```json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "채널 ID"
    },
    "title": {
      "type": "string",
      "description": "채널 이름"
    },
    "is_verified": {
      "type": "boolean",
      "description": "채널 인증 여부"
    },
    "link": {
      "type": "string",
      "description": "채널 링크"
    }
  }
}
```

### ResponseFc5Af1Fcba22_PlaylistVideo

`#/components/schemas/ResponseFc5Af1Fcba22_PlaylistVideo`

```json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "동영상 ID"
    },
    "title": {
      "type": "string",
      "description": "동영상 제목"
    },
    "link": {
      "type": "string",
      "description": "동영상 링크"
    },
    "length": {
      "type": "string",
      "description": "동영상 길이"
    }
  }
}
```

### ResponseFc5Af1Fcba22_Post

`#/components/schemas/ResponseFc5Af1Fcba22_Post`

```json
{
  "type": "object",
  "properties": {
    "position": {
      "type": "integer",
      "description": "게시물 섹션 내 위치"
    },
    "id": {
      "type": "string",
      "description": "게시물 ID"
    },
    "link": {
      "type": "string",
      "description": "게시물 링크"
    },
    "text": {
      "type": "string",
      "description": "게시물 텍스트 콘텐츠"
    },
    "likes": {
      "type": "string",
      "description": "좋아요 수 텍스트"
    },
    "extracted_likes": {
      "type": "integer",
      "description": "정수로 표시된 좋아요 수"
    },
    "comments": {
      "type": "string",
      "description": "댓글 수 텍스트"
    },
    "extracted_comments": {
      "type": "integer",
      "description": "정수로 표시된 댓글 수"
    },
    "channel": {
      "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_PostChannel"
    },
    "published_time": {
      "type": "string",
      "description": "게시 후 경과 시간"
    },
    "thumbnail": {
      "type": "string",
      "description": "게시물 썸네일 URL"
    }
  }
}
```

### ResponseFc5Af1Fcba22_PostChannel

`#/components/schemas/ResponseFc5Af1Fcba22_PostChannel`

```json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "채널 ID"
    },
    "title": {
      "type": "string",
      "description": "채널 이름"
    },
    "link": {
      "type": "string",
      "description": "채널 링크"
    },
    "is_verified": {
      "type": "boolean",
      "description": "채널 인증 여부"
    },
    "thumbnail": {
      "type": "string",
      "description": "채널 썸네일 URL"
    }
  }
}
```

### ResponseFc5Af1Fcba22_Posts

`#/components/schemas/ResponseFc5Af1Fcba22_Posts`

```json
{
  "type": "object",
  "properties": {
    "section_title": {
      "type": "string",
      "description": "게시물 섹션 제목"
    },
    "position": {
      "type": "integer",
      "description": "검색 결과 내 위치"
    },
    "items": {
      "type": "array",
      "description": "커뮤니티 게시물",
      "items": {
        "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_Post"
      }
    }
  }
}
```

### ResponseFc5Af1Fcba22_SearchInformation

`#/components/schemas/ResponseFc5Af1Fcba22_SearchInformation`

```json
{
  "type": "object",
  "properties": {
    "total_results": {
      "type": "integer",
      "description": "발견된 총 결과 수"
    },
    "state": {
      "type": "string",
      "description": "적용되는 경우 쿼리 수정 상태"
    },
    "original_query": {
      "type": "string",
      "description": "수정 전 원래 쿼리"
    },
    "original_query_sp": {
      "type": "string",
      "description": "원래 쿼리의 SP 매개변수"
    },
    "corrected_query": {
      "type": "string",
      "description": "맞춤법 수정이 적용된 경우 수정된 쿼리"
    }
  }
}
```

### ResponseFc5Af1Fcba22_SearchMetadata

`#/components/schemas/ResponseFc5Af1Fcba22_SearchMetadata`

```json
{
  "type": "object",
  "required": [
    "id",
    "status",
    "created_at"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "검색 요청의 고유 식별자"
    },
    "status": {
      "type": "string",
      "description": "검색 요청 상태"
    },
    "created_at": {
      "type": "string",
      "format": "date-time",
      "description": "검색이 생성된 타임스탬프"
    },
    "request_time_taken": {
      "type": "number",
      "description": "요청을 수행하는 데 걸린 시간(초)"
    },
    "parsing_time_taken": {
      "type": "number",
      "description": "결과를 파싱하는 데 걸린 시간(초)"
    },
    "total_time_taken": {
      "type": "number",
      "description": "검색에 걸린 총 시간(초)"
    },
    "request_url": {
      "type": "string",
      "description": "이 검색의 YouTube URL"
    },
    "html_url": {
      "type": "string",
      "description": "HTML 결과를 보는 URL"
    },
    "json_url": {
      "type": "string",
      "description": "JSON 결과를 보는 URL"
    }
  }
}
```

### ResponseFc5Af1Fcba22_SearchParameters

`#/components/schemas/ResponseFc5Af1Fcba22_SearchParameters`

```json
{
  "type": "object",
  "properties": {
    "engine": {
      "type": "string",
      "description": "사용된 검색 엔진"
    },
    "q": {
      "type": "string",
      "description": "사용된 검색어"
    },
    "sp": {
      "type": "string",
      "description": "사용된 필터/페이지네이션 매개변수"
    },
    "hl": {
      "type": "string",
      "description": "사용된 인터페이스 언어"
    },
    "gl": {
      "type": "string",
      "description": "사용된 국가 코드"
    }
  }
}
```

### ResponseFc5Af1Fcba22_SearchResponse

`#/components/schemas/ResponseFc5Af1Fcba22_SearchResponse`

```json
{
  "type": "object",
  "properties": {
    "search_metadata": {
      "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_SearchMetadata"
    },
    "search_parameters": {
      "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_SearchParameters"
    },
    "search_information": {
      "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_SearchInformation"
    },
    "suggestions": {
      "type": "array",
      "description": "검색어 추천",
      "items": {
        "type": "string"
      }
    },
    "ads": {
      "type": "array",
      "description": "광고 결과",
      "items": {
        "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_Ad"
      }
    },
    "channels": {
      "type": "array",
      "description": "YouTube 채널 결과",
      "items": {
        "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_Channel"
      }
    },
    "movies": {
      "type": "array",
      "description": "영화 결과",
      "items": {
        "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_Movie"
      }
    },
    "videos": {
      "type": "array",
      "description": "동영상 검색 결과",
      "items": {
        "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_Video"
      }
    },
    "playlists": {
      "type": "array",
      "description": "재생목록 결과",
      "items": {
        "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_Playlist"
      }
    },
    "sections": {
      "type": "array",
      "description": "섹션 결과",
      "items": {
        "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_Section"
      }
    },
    "shorts": {
      "type": "array",
      "description": "YouTube Shorts 결과",
      "items": {
        "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_Shorts"
      }
    },
    "posts": {
      "type": "array",
      "description": "커뮤니티 게시물 결과",
      "items": {
        "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_Posts"
      }
    },
    "people_also_search_for": {
      "type": "array",
      "description": "관련 검색 추천",
      "items": {
        "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_PeopleAlsoSearchFor"
      }
    },
    "featured_channel": {
      "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_FeaturedChannel"
    },
    "pagination": {
      "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_Pagination"
    },
    "error": {
      "type": "string",
      "description": "검색이 실패한 경우의 오류 메시지"
    }
  }
}
```

### ResponseFc5Af1Fcba22_Section

`#/components/schemas/ResponseFc5Af1Fcba22_Section`

```json
{
  "type": "object",
  "properties": {
    "section_title": {
      "type": "string",
      "description": "섹션 제목"
    },
    "position": {
      "type": "integer",
      "description": "검색 결과 내 위치"
    },
    "items": {
      "type": "array",
      "description": "섹션의 항목",
      "items": {
        "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_SectionItem"
      }
    }
  }
}
```

### ResponseFc5Af1Fcba22_SectionChannel

`#/components/schemas/ResponseFc5Af1Fcba22_SectionChannel`

```json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "채널 ID"
    },
    "title": {
      "type": "string",
      "description": "채널 이름"
    },
    "link": {
      "type": "string",
      "description": "채널 링크"
    }
  }
}
```

### ResponseFc5Af1Fcba22_SectionItem

`#/components/schemas/ResponseFc5Af1Fcba22_SectionItem`

```json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "항목 ID"
    },
    "title": {
      "type": "string",
      "description": "항목 제목"
    },
    "link": {
      "type": "string",
      "description": "항목 링크"
    },
    "channel": {
      "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_SectionChannel"
    },
    "views": {
      "type": "integer",
      "description": "조회수"
    },
    "published_time": {
      "type": "string",
      "description": "게시 후 경과 시간"
    },
    "length": {
      "type": "string",
      "description": "항목 길이"
    },
    "thumbnail": {
      "type": "string",
      "description": "항목 썸네일 URL"
    }
  }
}
```

### ResponseFc5Af1Fcba22_Short

`#/components/schemas/ResponseFc5Af1Fcba22_Short`

```json
{
  "type": "object",
  "properties": {
    "position": {
      "type": "integer",
      "description": "Shorts 섹션 내 위치"
    },
    "id": {
      "type": "string",
      "description": "Shorts 동영상 ID"
    },
    "title": {
      "type": "string",
      "description": "Shorts 제목"
    },
    "link": {
      "type": "string",
      "description": "Shorts 링크"
    },
    "duration": {
      "type": "string",
      "description": "Shorts 길이"
    },
    "views": {
      "type": "integer",
      "description": "조회수"
    },
    "thumbnail": {
      "type": "string",
      "description": "Shorts 썸네일 URL"
    }
  }
}
```

### ResponseFc5Af1Fcba22_Shorts

`#/components/schemas/ResponseFc5Af1Fcba22_Shorts`

```json
{
  "type": "object",
  "properties": {
    "section_title": {
      "type": "string",
      "description": "Shorts 섹션 제목"
    },
    "position": {
      "type": "integer",
      "description": "검색 결과 내 위치"
    },
    "items": {
      "type": "array",
      "description": "Shorts 동영상",
      "items": {
        "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_Short"
      }
    }
  }
}
```

### ResponseFc5Af1Fcba22_Thumbnail

`#/components/schemas/ResponseFc5Af1Fcba22_Thumbnail`

```json
{
  "type": "object",
  "properties": {
    "static": {
      "type": "string",
      "description": "정적 썸네일 URL"
    },
    "rich": {
      "type": "string",
      "description": "리치/애니메이션 썸네일 URL"
    }
  }
}
```

### ResponseFc5Af1Fcba22_Video

`#/components/schemas/ResponseFc5Af1Fcba22_Video`

```json
{
  "type": "object",
  "properties": {
    "position": {
      "type": "integer",
      "description": "검색 결과 내 위치"
    },
    "id": {
      "type": "string",
      "description": "YouTube 동영상 ID"
    },
    "title": {
      "type": "string",
      "description": "동영상 제목"
    },
    "link": {
      "type": "string",
      "description": "동영상 링크"
    },
    "description": {
      "type": "string",
      "description": "동영상 설명 스니펫"
    },
    "views": {
      "type": "integer",
      "description": "조회수"
    },
    "is_live": {
      "type": "boolean",
      "description": "동영상이 현재 라이브인지 여부"
    },
    "channel": {
      "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_VideoChannel"
    },
    "length": {
      "type": "string",
      "description": "동영상 길이"
    },
    "published_time": {
      "type": "string",
      "description": "게시 후 경과 시간"
    },
    "badges": {
      "type": "array",
      "description": "동영상 배지",
      "items": {
        "type": "string"
      }
    },
    "thumbnail": {
      "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_Thumbnail"
    },
    "key_moments": {
      "type": "array",
      "description": "동영상의 주요 모멘트",
      "items": {
        "$ref": "#/components/schemas/ResponseFc5Af1Fcba22_KeyMoment"
      }
    }
  }
}
```

### ResponseFc5Af1Fcba22_VideoChannel

`#/components/schemas/ResponseFc5Af1Fcba22_VideoChannel`

```json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "채널 ID"
    },
    "title": {
      "type": "string",
      "description": "채널 이름"
    },
    "link": {
      "type": "string",
      "description": "채널 링크"
    },
    "is_verified": {
      "type": "boolean",
      "description": "채널 인증 여부"
    },
    "thumbnail": {
      "type": "string",
      "description": "채널 썸네일 URL"
    }
  }
}
```