GuidesAPI GuideChangelog
Log In
API Guide

방송별 시청자 조회

조회 기간의 VOD 방송별 시청자 분포(회원유형·OS·연령·성별)를 조회합니다.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

기간 규칙: KST 자정 필요 — searchStartDt·searchEndDt 를 KST 자정(T15:00:00Z)에 맞춰야 합니다 기간 규칙 보기

정렬 편성 시작 시각(programmingStartDt) 내림차순(최신 먼저), 같으면 broadcastId 오름차순. 시각이 없는 방송은 맨 뒤.

오류

  • 400 C001 — 필수 파라미터 누락, 날짜 형식 오류(Z 아님·소수 초), searchStartDt ≥ searchEndDt, 시작 시각이 미래, partnerId 형식 오류
  • 400 OA001 — searchStartDt/searchEndDt 가 KST 자정(T15:00:00Z) 경계에 맞지 않음
  • 400 OA002 — 조회 기간이 31일 초과

인증·권한·서버 오류 등 공통 오류는 오류 코드를 참고하세요.

Path Params
string
required

파트너 ID. 토큰의 파트너와 같아야 합니다.

Query Params
date-time
required

조회 시작 시각(포함). UTC Z 형식. KST 자정(T15:00:00Z)에 맞춰야 합니다.

date-time
required

조회 종료 시각(미포함). 시작부터 최대 31일. KST 자정(T15:00:00Z)에 맞춰야 합니다.

Headers
string
required
Defaults to 2026-10-28

API 버전 (날짜 형식). 이 명세는 2026-10-28 버전입니다. 없거나 다르면 404 C003 입니다.

string

요청 추적 ID(선택). 영문·숫자·- _ . : 128자 이하. 보내지 않거나 형식이 다르면 서버가 만들어 응답 헤더로 돌려줍니다.

Responses

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
*/*
🏠 소스라이브 🎬 소스클립 🔗 소스링크 📢 소스애드
🧩 API 가이드
🆕 최근 업데이트
💬 도움이 더 필요하신가요?
메일로 문의 카카오톡 채널로 문의
담당자에게 문의하기

궁금한 점이나 불편했던 점을 남겨주시면 담당자가 확인 후 답변드릴게요.

가이드 챗봇
* AI를 활용해 답변해서 사실과 다를 수도 있어요. 더 궁금한 사항은 '담당자에게 문의하기'를 이용해주세요.
💡 궁금한 솔루션(예: 라이브, 링크 등)을 함께 적어주시면 더 정확한 답변을 받을 수 있어요.