bldinit Youtube Analytics Rest API
The youtube_analytics-rest API from bldinit — 3 operation(s) for youtube_analytics-rest.
The youtube_analytics-rest API from bldinit — 3 operation(s) for youtube_analytics-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-analytics-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 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)