bldinit Youtube Analytics Rest API

The youtube_analytics-rest API from bldinit — 3 operation(s) for youtube_analytics-rest.

GitHub OpenAPI

Operations 3

GET /api/v1/youtube_analytics/v2/reports YouTube 채널 분석 리포트 조회 (조회수·시청시간·구독자·추정 수익) #
GET /api/v1/youtube_analytics/v2/groups YouTube Analytics 그룹 목록 조회 #
GET /api/v1/youtube_analytics/v2/groupItems YouTube 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-analytics-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-analytics-rest-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: mcpweave Youtube Analytics Rest API
  description: Asia-native MCP Gateway — Native pass-through, FastMCP, Paddle+Toss billing
  version: '2026-04-27'
tags:
- name: youtube_analytics-rest
paths:
  /api/v1/youtube_analytics/v2/reports:
    get:
      tags:
      - youtube_analytics-rest
      summary: YouTube 채널 분석 리포트 조회 (조회수·시청시간·구독자·추정 수익)
      description: 'YouTube Analytics API v2 핵심 엔드포인트. 채널의 조회수·시청시간·구독자 증감·

        추정 수익 등을 날짜별·국가별·동영상별·디바이스별 등 다양한 차원으로 조회합니다.


        **기본 사용법 (내 채널 지난 28일 일별)**:

        ids=channel==MINE, startDate=2026-05-08, endDate=2026-06-04,

        metrics=views,estimatedMinutesWatched,subscribersGained, dimensions=day, sort=day


        **ids 형식**:

        - ``channel==MINE`` — 인증된 사용자의 채널 (Phase 1 기본)

        - ``channel==UC...`` — 특정 채널 ID (내가 소유한 채널)


        **자주 쓰는 metrics** (쉼표 구분):

        - 조회/참여: views / estimatedMinutesWatched / averageViewDuration /

        averageViewPercentage / likes / comments / shares /

        subscribersGained / subscribersLost

        - 수익 (yt-analytics-monetary.readonly 필요):

        estimatedRevenue / estimatedAdRevenue / grossRevenue /

        cpm / playbackBasedCpm / adImpressions / monetizedPlaybacks

        - 라이브: averageConcurrentViewers / peakConcurrentViewers

        - 카드: cardImpressions / cardClicks / cardClickRate


        **자주 쓰는 dimensions** (쉼표 구분):

        - 시간: day (YYYY-MM-DD) / month (YYYY-MM)

        - 지역: country (ISO 2자리) / province (US 주, filters=country==US 필요) / city (sort 필수)

        - 콘텐츠: video / playlist

        - 디바이스: deviceType / operatingSystem / youtubeProduct

        - 트래픽: insightTrafficSourceType / insightTrafficSourceDetail

        - 시청자: ageGroup / gender / subscribedStatus / liveOrOnDemand / creatorContentType

        - 재생위치: insightPlaybackLocationType


        **filters 문법**: dimension==value (AND: 세미콜론 구분 / OR: 쉼표 구분)

        예: ``filters=video==videoId;country==KR``


        **알려진 제약**:

        - liveOrOnDemand 는 averageViewPercentage 와 함께 사용 불가

        - city 리포트: sort 파라미터 필수 (최대 250행)

        - Top Videos: sort 필수 (최대 200행)

        - 인구통계(ageGroup/gender): 소규모 채널은 익명화로 일부 행 생략 가능

        - ⚠️ rows 키는 데이터 없을 때 빈 배열이 아닌 **생략**됨 (nil-safe 처리 필요)


        **응답 구조**:

        columnHeaders[]: [{name, columnType(DIMENSION|METRIC), dataType(STRING|INTEGER|FLOAT)}]

        rows[]: [[값1, 값2, ...]] (차원이 먼저, 그 다음 지표 — 요청 순서와 동일)

        kind: "youtubeAnalytics#resultTable"'
      operationId: youtube_analytics_query_report
      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: sort
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Sort
      - name: maxResults
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Maxresults
      - name: startIndex
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Startindex
      - name: currency
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Currency
      - 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_analytics/v2/groups:
    get:
      tags:
      - youtube_analytics-rest
      summary: YouTube Analytics 그룹 목록 조회
      description: '인증된 사용자가 소유한 YouTube Analytics 그룹 목록을 반환합니다.

        Analytics 그룹은 여러 동영상·재생목록·채널을 묶어 일괄 분석하는 기능입니다.

        그룹 ID 는 ``youtube_analytics_query_report`` 의 filters 파라미터

        (``filters=group==GROUP_ID``) 에 사용할 수 있습니다.


        **사용법**: mine=true (내 모든 그룹) 또는 id={GROUP_ID} (특정 그룹).

        id 와 mine 중 하나는 반드시 지정해야 합니다.


        **응답**: kind="youtube#groupListResponse" / items[] / nextPageToken

        items[].id: 그룹 ID (reports.query filters=group==ID 에 사용)

        items[].snippet.title: 그룹 이름

        items[].contentDetails.itemCount: 그룹 내 항목 수 (최대 500)

        items[].contentDetails.itemType: youtube#video / youtube#playlist / youtube#channel'
      operationId: youtube_analytics_list_groups
      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: id
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Id
      - 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_analytics/v2/groupItems:
    get:
      tags:
      - youtube_analytics-rest
      summary: YouTube Analytics 그룹 내 항목 조회
      description: '특정 YouTube Analytics 그룹에 속한 항목(동영상·재생목록·채널) 목록을 반환합니다.

        ``youtube_analytics_list_groups`` 로 그룹 ID 를 먼저 조회한 후 사용합니다.


        **사용 흐름**:

        1. youtube_analytics_list_groups (mine=true) → 그룹 목록 확인

        2. youtube_analytics_list_group_items (groupId=GROUP_ID) → 그룹 내 항목 확인

        3. youtube_analytics_query_report (filters=group==GROUP_ID 또는 video==VID1,VID2) → 분석


        **응답**: kind="youtube#groupItemListResponse" / items[]

        items[].resource.kind: youtube#video / youtube#playlist / youtube#channel

        items[].resource.id: 동영상/재생목록/채널 ID

        ⚠️ 페이지네이션 없음 — 그룹당 최대 500 항목, 단일 응답으로 전체 반환.'
      operationId: youtube_analytics_list_group_items
      parameters:
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: groupId
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Groupid
      - 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)