GuidesAPI GuideChangelog
Log In
API Guide

방송 시계열 조회

VOD 방송 한 건의 지표 추이를 시간 또는 일 단위로 조회합니다.

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

기간 규칙: 일=KST 자정 · 시간=정시 — 일 단위면 KST 자정, 시간 단위면 정시에 맞춥니다 기간 규칙 보기

  • 버킷 단위는 기간으로 자동 결정됩니다: searchStartDt 와 (searchEndDt − 1초)가 같은 KST 날짜이면 PT1H, 아니면 P1D. interval 파라미터는 받지 않습니다.
  • 다른 VOD API 와 달리, 일 단위면 KST 자정(T15:00:00Z), 시간 단위면 정시에 맞추면 됩니다(위반 시 400 OA001).

정렬 data 는 statsDateTime 오름차순입니다.

📘

시계열 API 입니다. 응답 meta.interval 에 버킷 단위가 담깁니다. 시계열 단위 참고

오류

  • 400 C001 — 필수 파라미터 누락, 날짜 형식 오류(Z 아님·소수 초), searchStartDt ≥ searchEndDt, 시작 시각이 미래, partnerId 형식 오류
  • 400 C001 — broadcastId 형식 오류(vc·vk 로 시작하지 않음·5자 미만, Live 방송 ID 사용)
  • 400 OA001 — 일 단위 버킷인데 KST 자정(T15:00:00Z), 시간 단위 버킷인데 정시에 맞지 않음
  • 400 OA002 — 조회 기간이 31일 초과
  • 404 B001 — 해당 파트너에 broadcastId 방송이 없음(다른 파트너 방송도 404)

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

Path Params
string
required

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

string
required

VOD 방송 ID (vc·vk 로 시작).

Query Params
date-time
required

조회 시작 시각(포함). UTC Z 형식. 일 단위면 KST 자정, 시간 단위면 정시에 맞춥니다.

date-time
required

조회 종료 시각(미포함). 시작부터 최대 31일. 일 단위면 KST 자정, 시간 단위면 정시에 맞춥니다.

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