bldinit Youtube Rest API
The youtube-rest API from bldinit — 9 operation(s) for youtube-rest.
The youtube-rest API from bldinit — 9 operation(s) for youtube-rest.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/mcpweave-com:mcpweave-com-youtube-rest-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: mcpweave Youtube Rest API
description: Asia-native MCP Gateway — Native pass-through, FastMCP, Paddle+Toss billing
version: '2026-04-27'
tags:
- name: youtube-rest
paths:
/api/v1/youtube/channels:
get:
tags:
- youtube-rest
summary: 내 채널 정보 조회
description: '``mine=true`` 로 OAuth 인증된 사용자의 채널 정보 반환. Brand account
보유 시 OAuth flow 에서 어느 채널 사용할지 선택 후 발급된 token 의
대상 채널.
``part`` 로 필요한 필드 select — snippet (제목/설명/썸네일), contentDetails
(uploads playlist), statistics (구독자수/조회수). 다중 part 는 comma 로.
Quota cost: 1 unit. Native pass-through.'
operationId: youtube_get_channel
parameters:
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: mine
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mine
- name: part
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Part
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
/api/v1/youtube/videos:
get:
tags:
- youtube-rest
summary: 영상 detail 조회
description: '``id`` (video_id) 로 영상 metadata + statistics 조회.
``part``: snippet (제목/설명/태그/카테고리/썸네일), contentDetails (duration/dimension),
statistics (조회수/좋아요/댓글수), status (uploadStatus, privacyStatus).
Quota cost: 1 unit / part. Native pass-through.'
operationId: youtube_get_video
parameters:
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: id
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Id
- name: part
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Part
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
put:
tags:
- youtube-rest
summary: 영상 metadata 수정
description: '영상의 snippet / status 수정. ``id`` (videoId) 는 body 에 포함되어야 함
(``snippet.title`` / ``snippet.description`` / ``snippet.tags`` / ``snippet.categoryId``
/ ``status.privacyStatus`` 등).
``part`` query 에 수정할 part 명시 (snippet 또는 status).
Recoverable — 다시 PUT 으로 이전 값 복원 가능 (history 추적 X 다만
application 측에서 이전 값 저장 후 복원 가능). irreversible 아님.
Quota cost: 50 units. Native pass-through.'
operationId: youtube_update_video
parameters:
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: part
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Part
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
requestBody:
content:
application/json:
schema:
anyOf:
- type: object
additionalProperties: true
- type: 'null'
title: Body
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
/api/v1/youtube/search:
get:
tags:
- youtube-rest
summary: 영상 검색
description: '``q`` (query) 또는 ``forMine=true`` (내 영상만) 로 검색.
- ``forMine=true`` + ``type=video`` 조합 = 내 채널 영상 list
- ``q`` only = public 영상 검색
Quota cost: **100 units** (가장 비싼 op). Pagination via ``pageToken``.
Native pass-through.'
operationId: youtube_search_videos
parameters:
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: q
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Q
- name: forMine
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Formine
- name: type
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Type
- name: part
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Part
- name: maxResults
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Maxresults
- name: pageToken
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Pagetoken
- name: order
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Order
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
/api/v1/youtube/commentThreads:
get:
tags:
- youtube-rest
summary: 영상 댓글 list
description: '``videoId`` 의 top-level 댓글 list. ``part=snippet,replies`` 권장 (replies
포함 시 1 depth 의 답글까지 같이 반환).
Quota cost: 1 unit. Pagination via ``pageToken``.
Native pass-through.'
operationId: youtube_list_video_comments
parameters:
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: videoId
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Videoid
- name: part
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Part
- name: maxResults
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Maxresults
- name: pageToken
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Pagetoken
- name: order
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Order
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
/api/v1/youtube/comments:
post:
tags:
- youtube-rest
summary: 댓글에 답글 작성 (★ irreversible)
description: '기존 댓글 (``parentId``) 에 답글 작성. 작성된 답글 = 영상 작성자 +
모든 viewers 에게 공개 노출.
**Irreversible (ADR-028/030 Cat A — 외부 도달)**: mcpweave 가 댓글
삭제 가능하지만, 답글 발송 후 알림 / 캐시 / 인용 = 회수 불가.
client 가 첫 호출 시 ``confirmation_token`` 발급, 재호출 시 검증.
Quota cost: 50 units.
Native pass-through.'
operationId: youtube_reply_comment
parameters:
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: part
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Part
- name: confirmation_token
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: 'ADR-030: required for irreversible op. First call returns token.'
title: Confirmation Token
description: 'ADR-030: required for irreversible op. First call returns token.'
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
requestBody:
content:
application/json:
schema:
anyOf:
- type: object
additionalProperties: true
- type: 'null'
title: Body
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
/api/v1/youtube/playlists:
get:
tags:
- youtube-rest
summary: 내 재생목록 list
description: '``mine=true`` 로 인증된 사용자의 재생목록 list.
Quota cost: 1 unit. Pagination via ``pageToken``.
Native pass-through.'
operationId: youtube_list_playlists
parameters:
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: mine
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mine
- name: part
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Part
- name: maxResults
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Maxresults
- name: pageToken
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Pagetoken
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
/api/v1/youtube/playlistItems:
post:
tags:
- youtube-rest
summary: 재생목록에 영상 추가
description: '``playlistId`` 에 ``videoId`` 영상 추가. 같은 영상 중복 추가 가능
(Google 측 중복 체크 X).
Recoverable — DELETE /playlistItems/{id} 로 제거 가능. irreversible 아님.
Quota cost: 50 units.
Native pass-through.'
operationId: youtube_add_to_playlist
parameters:
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: part
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Part
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
requestBody:
content:
application/json:
schema:
anyOf:
- type: object
additionalProperties: true
- type: 'null'
title: Body
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
/api/v1/youtube/videoCategories:
get:
tags:
- youtube-rest
summary: 영상 카테고리 list (지역별)
description: '지역별 사용 가능한 영상 카테고리 list. ``youtube_update_video`` 의
``snippet.categoryId`` 결정 시 참고.
``regionCode`` 별 카테고리 차이 — KR (한국) / US / JP 등.
Quota cost: 1 unit. Native pass-through.'
operationId: youtube_list_video_categories
parameters:
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: part
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Part
- name: regionCode
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Regioncode
- name: hl
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Hl
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
/api/v1/youtubehttps://youtubeanalytics.googleapis.com/v2/reports:
get:
tags:
- youtube-rest
summary: 영상 / 채널 Analytics 통계
description: 'Analytics API (https://youtubeanalytics.googleapis.com/v2). Data API
와 다른 host 라 yaml path 가 절대경로.
``ids=channel==MINE`` 고정 (인증된 사용자 채널). ``metrics`` 선택
(views / likes / comments / estimatedMinutesWatched / averageViewDuration 등),
``dimensions`` 선택 (day / video / country 등).
Quota cost: 1 unit (Analytics API).
Native pass-through.'
operationId: youtube_get_video_analytics
parameters:
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: ids
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Ids
- name: startDate
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Startdate
- name: endDate
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Enddate
- name: metrics
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Metrics
- name: dimensions
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Dimensions
- name: filters
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Filters
- name: maxResults
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Maxresults
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)