GuidesAPI GuideChangelog
Log In
API Guide

유입경로별 시청자 조회

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

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

기간 규칙: 정렬 불필요 — 아무 UTC 시각이나 보낼 수 있습니다 기간 규칙 보기

  • 조회 기간에 시작한 방송을 집계합니다.
  • 진행된(LIVE) 방송만 집계합니다.

정렬 referrer 오름차순(문자열 순). referrer 값이 없는 항목은 맨 앞.

오류

  • 400 C001 — 필수 파라미터 누락, 날짜 형식 오류(Z 아님·소수 초), searchStartDt ≥ searchEndDt, 시작 시각이 미래, partnerId 형식 오류
  • 400 OA002 — 조회 기간이 31일 초과

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

Path Params
string
required

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

Query Params
date-time
required

조회 시작 시각(포함). UTC Z 형식.

date-time
required

조회 종료 시각(미포함). 시작부터 최대 31일.

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