bldinit Youtube Rest API

The youtube-rest API from bldinit — 9 operation(s) for youtube-rest.

GitHub OpenAPI

Operations 10

GET /api/v1/youtube/channels 내 채널 정보 조회 #
GET /api/v1/youtube/videos 영상 detail 조회 #
PUT /api/v1/youtube/videos 영상 metadata 수정 #
GET /api/v1/youtube/search 영상 검색 #
GET /api/v1/youtube/commentThreads 영상 댓글 list #
POST /api/v1/youtube/comments 댓글에 답글 작성 (★ irreversible) #
GET /api/v1/youtube/playlists 내 재생목록 list #
POST /api/v1/youtube/playlistItems 재생목록에 영상 추가 #
GET /api/v1/youtube/videoCategories 영상 카테고리 list (지역별) #
GET /api/v1/youtubehttps://youtubeanalytics.googleapis.com/v2/reports 영상 / 채널 Analytics 통계 #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/mcpweave-com:mcpweave-com-youtube-rest-api"
All apis
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.

Get an API 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 Specification

mcpweave-com-youtube-rest-api-openapi.yml Raw ↑
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)