---
title: "Get comments on a YouTube video"
method: GET
path: "/api/v1/youtube/comments"
---

# Get comments on a YouTube video

`GET /api/v1/youtube/comments`

## Request

- Base URL: `https://localhost:3000`
- URL: `https://localhost:3000/api/v1/youtube/comments`
- Auth: OAuth 2 (authorization code, authorization URL `/oauth/authorize`, token URL `/oauth/token`)

Retrieve comments from a YouTube video, sorted by relevance or time. Useful for gauging audience reaction, finding questions, or understanding discussion around a video.

## Query parameters

- `video_id` string, required
- `max_results` integer
- `order` 'relevance' | 'time'
- `page_token` string

## Response `200`

Video comments

- YouTubeCommentsResponse
  - `user` string
  - `provider` string
  - `video_id` string
  - `comments` object[]
    - `comment_id` string
    - `author` string
    - `author_channel_id` string
    - `text` string
    - `like_count` integer
    - `published_at` string
    - `reply_count` integer
  - `total_results` integer
  - `next_page_token` string
  - `_meta` object
    - `source` string
    - `authoritative` boolean

## Other responses

- `401`: Authentication required
- `500`: Internal server error

---

[API](https://skmtc.dev/corpusiq/apis/multi-source-mcp-api.md) · [All operations](https://skmtc.dev/corpusiq/apis/multi-source-mcp-api/llms.txt) · [OpenAPI document](https://skmtc.dev/corpusiq/apis/multi-source-mcp-api/revisions/e25648ba6027?raw)