크리에이터 시청자 분석은(는) 무엇을 하나요?

YouTube는 시청자 인구 통계를 공개하지 않습니다. youtube-channel-profile이 사용하는 Data API에도 해당 정보가 없습니다. 신뢰할 수 있는 출처는 두 가지뿐입니다: 채널 소유자가 동의하여 공유하는 자체 분석 데이터, 또는 인간 승인이 이루어진 유료 타사 추정치입니다. 그 외의 모든 것은 추측에 불과하며, 그렇다고 명시해야 합니다.

동의 규칙

소유자 데이터는 소유자로부터 제공됩니다. 소유자는 무엇을, 어떤 날짜 범위로, 누가 볼 수 있는지 결정합니다. 접근을 요청하기 전에 이메일이나 메시지 등 서면 동의를 받으십시오.
소유자는 자신의 계정으로 직접 로그인합니다. 비밀번호나 로그인 코드를 요청하거나 대신 입력하지 마십시오.
비용 지출은 승인이 필요합니다. 유료 조회를 수행하기 전에 비용을 명시하고 인간에게 먼저 확인을 받으십시오.
이름, 얼굴, 목소리, 댓글, 썸네일을 통해 연령, 성별, 또는 위치를 추측하지 마십시오.
데이터는 작업 목적으로만 보관하고, 소유자와 승인된 사람에게만 표시하십시오(YouTube 정책 III.E.3.b). 요청 시 7일 이내에 삭제하십시오(III.E.4.g). 보관하는 경우 30일마다 소유자의 동의를 다시 확인하십시오(III.E.4.b).

경로 1: 소유자가 YouTube 스튜디오에서 공유 (여기서 시작)

API 작업이 필요 없으며, 일회성 브리핑에 적합합니다.

옵션 A, 내보내기: 소유자에게 YouTube 스튜디오를 열고, 분석(Analytics) > 시청자(Audience) 탭으로 이동하도록 요청합니다. 날짜 범위(최근 90일이 기본값으로 좋음)를 선택한 후, 연령, 성별, 상위 국가에 대한 스크린샷 또는 내보내기 파일을 공유하도록 합니다.

옵션 B, 읽기 전용 접근: 소유자가 YouTube 스튜디오를 열고 설정(Settings) > 권한(Permissions) > 초대(Invite)로 이동합니다. 인간의 Google 계정 이메일을 입력하고 뷰어(제한됨)(Viewer (Limited)) 역할을 선택합니다. 이 역할은 분석 데이터를 볼 수 있지만 수익은 볼 수 없습니다. 초대는 30일 후에 만료됩니다. 작업이 끝나면 소유자는 동일한 화면에서 접근 권한을 제거합니다. 브랜드 계정 채널의 경우 먼저 채널 권한으로 이동해야 합니다.

경로 2: YouTube Analytics API (반복 또는 대규모 작업)

소유자나 팀이 직접 실행하거나, 서면 동의가 있는 지속적인 작업의 경우 사용합니다.

Google Cloud에서 프로젝트를 생성합니다. YouTube Analytics API와 YouTube Data API v3를 활성화합니다.
OAuth 동의 화면을 설정합니다: 사용자 유형 외부, 게시 상태 테스트. 소유자의 Google 계정을 테스트 사용자로 추가합니다.
데스크톱 앱 유형의 OAuth 클라이언트 ID를 생성하고 클라이언트 파일을 다운로드합니다. 이를 비밀로 취급합니다.
다음 범위만 요청합니다:
- https://www.googleapis.com/auth/yt-analytics.readonly
- https://www.googleapis.com/auth/youtube.readonly (reports.query 참조에서도 필요함)
- yt-analytics-monetary.readonly는 소유자가 수익 공유에 동의한 경우에만 추가합니다.
소유자가 직접 로그인하는 머신에서 로그인을 실행합니다. 예:

# pip install google-auth-oauthlib requests
from google_auth_oauthlib.flow import InstalledAppFlow
import requests
SCOPES = ["https://www.googleapis.com/auth/yt-analytics.readonly",
          "https://www.googleapis.com/auth/youtube.readonly"]
creds = InstalledAppFlow.from_client_secrets_file("client_secret.json", SCOPES).run_local_server(port=0)
base = "https://youtubeanalytics.googleapis.com/v2/reports"
common = {"ids": "channel==MINE", "startDate": "2026-08-01", "endDate": "2026-10-31"}
auth = {"Authorization": f"Bearer {creds.token}"}
age_gender = requests.get(base, headers=auth, params={**common,
    "metrics": "viewerPercentage", "dimensions": "ageGroup,gender"}).json()
countries = requests.get(base, headers=auth, params={**common,
    "metrics": "views,estimatedMinutesWatched", "dimensions": "country",
    "sort": "-views", "maxResults": 10}).json()

Google에서 요청할 때 소유자가 올바른 채널을 선택합니다. channel==MINE은 소유자가 로그인한 채널을 의미합니다.
columnHeaders와 rows를 읽습니다. viewerPercentage는 로그인한 시청자만 포함합니다. 데이터가 없으면 YouTube에서 rows를 생략합니다. 이 경우 "사용 불가"로 보고하고 절대 0으로 보고하지 마십시오.
토큰은 메모리에만 보관합니다. 작업 후에는 취소합니다. 소유자는 myaccount.google.com/permissions에서 직접 취소할 수 있습니다. 테스트 앱의 리프레시 토큰도 7일 후에 만료됩니다.

경로 3: 유료 추정치 (Influencers Club MCP)

Influencers Club은 공개 유튜브 채널의 시청자 인구 통계를 추정합니다. 타사 모델이며 YouTube 데이터가 아닙니다. 각 조회는 크레딧을 사용합니다.

check_credits(무료)를 실행하고 잔액을 확인합니다.
인간에게 도구와 비용을 알리고 승인을 기다립니다. 서버 README에 따르면(2026년 11월 5일 확인): enrich_by_handle_analytics는 0.8 크레딧이며 시청자 인구 통계를 반환합니다. enrich_by_handle은 1 크레딧이며, 이전 서버에서는 시청자 섹션을 위해 include_audience_data를 true로 전달해야 합니다. enrich_by_handle_raw는 0.03 크레딧이며 시청자 데이터가 없습니다. 버전이 다를 수 있으므로 도구 자체의 설명을 먼저 읽으십시오.
하나의 채널에 대해 한 번의 호출을 수행하며, platform을 youtube로, handle을 핸들이나 채널 ID로 설정합니다.
호출 중 제한 또는 크레딧 오류가 발생하면 중단합니다. 재시도하지 말고 수행된 조회 수를 보고합니다.
이 목적으로 get_audience_locations 또는 get_audience_interests를 사용하지 마십시오. 이는 필터 값의 무료 목록이며 크리에이터의 시청자가 아닙니다.

결과에 "Influencers Club 추정"이라고 라벨을 붙이고 조회 날짜를 제공하며, 출처를 혼동하지 않도록 소유자 데이터와 절대 섞지 마십시오.

브리핑에 작성할 내용

각 수치의 출처: 소유자의 YouTube Analytics(날짜 범위 포함), 소유자의 스튜디오 내보내기, 또는 타사 추정치.
로그인한 시청자의 연령 및 성별 비율, 조회수 기준 상위 국가.
동의가 없고 승인된 지출이 없는 경우 "시청자 인구 통계: 소유자의 분석 데이터 또는 유료 추정치 없이는 확인할 수 없습니다."라고 작성합니다. 이것이 완전한 답변입니다.

2026년 11월 5일 YouTube Analytics API 참조, 지표 및 권한 부여 페이지, YouTube 도움말(채널 권한), Influencers Club MCP README 및 사용 제한을 기준으로 확인함.

크리에이터 시청자 분석