GuidesAPI GuideChangelog
Log In
API Guide

시계열 조회

조회 기간을 시간 또는 일 단위 버킷으로 나눠 Live 지표 추이와 버킷별 방송 목록을 조회합니다.

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

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

  • 버킷 단위는 기간으로 자동 결정됩니다: searchStartDt 와 (searchEndDt − 1초)가 같은 KST 날짜이면 시간 단위(PT1H), 아니면 일 단위(P1D).
  • 일 단위는 두 값 모두 KST 자정(T15:00:00Z), 시간 단위는 두 값 모두 정시여야 합니다(위반 시 400 OA001).
  • 결정된 버킷 단위는 응답 meta.interval 에 담깁니다(PT1H 또는 P1D).
  • 버킷의 averagePlaytime 은 총 시청 시간 ÷ 방송 수, broadcastList 항목의 averagePlaytime 은 총 시청 시간 ÷ UV 입니다.
  • 진행된(LIVE) 방송만 집계합니다.

정렬 data 는 statsDateTime 오름차순입니다. broadcastList 는 방송 시작 시각 내림차순입니다.

📘

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

오류

  • 400 C001 — 필수 파라미터 누락, 날짜 형식 오류(Z 아님·소수 초), searchStartDt ≥ searchEndDt, 시작 시각이 미래, partnerId 형식 오류
  • 400 C001 — interval 값이 지원하지 않는 형식이거나 자동 결정 값과 다름
  • 400 OA001 — 일 단위 버킷인데 KST 자정(T15:00:00Z), 시간 단위 버킷인데 정시에 맞지 않음
  • 400 OA002 — 조회 기간이 31일 초과

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

Path Params
string
required

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

Query Params
date-time
required

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

date-time
required

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

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