GuidesAPI GuideChangelog
Log In
API Guide

유입경로 시청자 성별 조회

조회 기간의 VOD 방송 시청자 중 유입경로(referrer) 값이 있는 시청자만 모아 성별 분포를 조회합니다(파트너 단위 1건).

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

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

  • referrer 값별로 나누지 않고, referrer 값이 있는 시청자만 모은 분포 1건을 돌려줍니다. referrer별 분해가 필요하면 목록형 엔드포인트를 사용하세요.

오류

  • 400 C001 — 필수 파라미터 누락, 날짜 형식 오류(Z 아님·소수 초), searchStartDt ≥ searchEndDt, 시작 시각이 미래, partnerId 형식 오류
  • 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)에 맞춰야 합니다.

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