GuidesAPI GuideChangelog
Log In
API Guide

시계열 조회

조회 기간을 시간 또는 일 단위 버킷으로 나눠 VOD 지표 추이를 조회합니다.

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

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

  • VOD 통계는 일 단위 데이터이므로 searchStartDt/searchEndDt 를 KST 자정(T15:00:00Z)에 맞춰야 합니다. 시간 단위가 되는 경우(KST 하루 조회)에도 마찬가지이므로, 시간 단위 시계열은 KST 하루 전체(24개 버킷)를 조회할 때만 나옵니다.
  • 버킷 단위는 기간으로 자동 결정됩니다: searchStartDt 와 (searchEndDt − 1초)가 같은 KST 날짜이면 PT1H, 아니면 P1D.
  • averagePlaytime 은 총 시청 시간 ÷ 방송 수(소수점 이하 버림)입니다.

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

📘

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

오류

  • 400 C001 — 필수 파라미터 누락, 날짜 형식 오류(Z 아님·소수 초), searchStartDt ≥ searchEndDt, 시작 시각이 미래, partnerId 형식 오류
  • 400 C001 — interval 값이 지원하지 않는 형식이거나 자동 결정 값과 다름
  • 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)에 맞춰야 합니다.

string
enum

보내지 않는 것을 권장합니다. 기간에 따라 PT1H 또는 P1D 로 자동 결정됩니다.

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