GuidesAPI GuideChangelog
Log In
API Guide

방송 시계열 조회

Live 방송 한 건의 시청자·반응 지표 추이를 1분·10분·1시간 단위로 조회합니다.

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

기간 규칙: 기간 없음 — 기간 파라미터 없이 방송 구간 전체를 집계합니다 기간 규칙 보기

  • 기간 파라미터가 없습니다. 방송 시작부터 종료(진행 중이면 현재)까지가 집계 구간입니다. 구간 정보는 응답에 담지 않습니다.
  • 아직 시작하지 않은 방송은 400 C001 입니다.
  • 방송 구간(시작 ~ 종료 또는 현재)이 7일을 넘으면 400 C001 입니다.
  • meta.interval 에 요청한 버킷 단위가 ISO-8601 형식(PT1M, PT10M, PT1H)으로 담깁니다.

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

📘

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

오류

  • 400 C001 — partnerId 형식 오류
  • 400 C001 — broadcastId 형식 오류, interval 이 허용 값이 아님, 시작 전 방송, 방송 구간 7일 초과
  • 404 B001 — 해당 파트너에 broadcastId 방송이 없음(다른 파트너 방송도 404)

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

Path Params
string
required

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

string
required

Live 방송 ID (lk 로 시작).

Query Params
string
enum
Defaults to 1m

1m(기본값), 10m, 1h 중에서 고릅니다.

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