---
title: "예정 라이브 조회"
method: GET
path: "/V1/front/broadcast/schedule"
---

# 예정 라이브 조회

`GET /V1/front/broadcast/schedule`

예정 라이브 조회 API입니다.

## Query parameters

- `partnerId` string, required
- `searchStartDt` string
- `searchEndDt` string
- `searchWord` string
- `returnLimit` string
- `nextKey` string

## Response `200`

200

- object
  - `code` string — 응답 코드
  - `timestamp` string — 타임스탬프
  - `requestId` string — 요청 ID
  - `message` string — 메세지
  - `response` object — 응답
    - `nextKey` string — 다음 페이지를 볼 수 있는 키
    - `totalCount` integer — 토탈 갯수
    - `count` integer — 현재 페이지 갯수
    - `items` object[] — 목록
      - `broadcastCategoryId1` string — 방송 카테고리 대분류 ID
      - `broadcastCategoryId2` string — 방송 카테고리 중분류 ID
      - `broadcastId` string — 방송 ID
      - `broadcastName` string — 방송명
      - `broadcastSecretTypeCode` string — 비밀 방송 코드(basic|secret)
      - `broadcastStateCode` string — 방송 상태 코드(accepted|standby|onair|switching|signoff|rehearsal|rehearsalonair|converting|vod|error|warning|cancel)
      - `broadcastThumbnailList` object[] — 썸네일 목록
        - `isRepresentative` string — 대표 여부
        - `thumbnailUrl` string — 썸네일 URL 주소
      - `broadcastTypeCode` string — 방송 종류 코드 (live|catchup|vod)
      - `etcLinkOpenType` string — 기타 url 이동 타입 (open|move|none)
      - `etcLinkUrl` string — 기타 URL
      - `explanation` string — 설명
      - `hashTagList` string — 해시태그 목록
      - `isTest` boolean — 테스트 여부
      - `outputInfo` string — 송출정보
      - `partnerId` string — 파트너 ID
      - `previewInfo` object — 미리보기 정보
        - `startTime` string — 미리보기 시작 초
        - `endTime` string — 미리 보기 종료 초
      - `programmingEndDt` string — 편성 종료 시간
      - `programmingStartDt` string — 편성 시작 시간
      - `roomId` string — 채팅 룸 ID
      - `serviceAdminId` string — 서비스 어드민 ID
      - `serviceManagerId` string — 서비스 매니져 ID
      - `serviceOperatorId` string — 서비스 운영자 ID
      - `shortUrl` string — 숏 링크
      - `thumbnailList` object[] — 썸네일 목록
        - `isRepresentative` string — 대표 여부
        - `isVod` string — VOD 여부
        - `thumbnailUrl` string — 썸네일URL
      - `useNotification` string — 알림 사용 여부
      - `usePurchaseEvent` string — 구매인증 이벤트 사용 여부
      - `totalDuration` string — 실제 방송 시간(초)
      - `outputPath` string — 플레이어 URL
      - `room` object[]
        - `chatCounterInfo` string — 채팅수
        - `incomingCounterInfo` string — 시청자수
        - `reactionCounterInfo` string — 좋아요수
      - `shopName` string — 상점명
      - `partnerProfileImageUrl` string — 상점 이미지 주소
      - `broadcastCategoryName1` string — 방송 카테고리 대분류명
      - `broadcastCategoryName2` string — 방송 카테고리 중분류명
      - `productListDetail` object[] — 상품 목록
        - `androidSchemeUrl` string — 안드로이드 스키마
        - `brandName` string — 브랜드명
        - `countryId` string — 국가 아이디
        - `currencyId` string — 통화 코드
        - `currencyNotation` string — 통화 기호
        - `discountPrice` string — 할인가
        - `discountRate` string — 할인율
        - `discountTypeCode` string — 할인 타입 코드
        - `externalProductId` string — 외부 상품 코드
        - `iosSchemeUrl` string — IOS 스키마
        - `isSoldout` string — 품절 여부
        - `languageTag` string — 언어 태그
        - `ord` string — 정렬 순서
        - `price` string — 판매가
        - `priceTypeCode` string — 가격정보구분코드(basic|text|hide)
        - `productCreatedSystemCode` string — 상품 생성 코드(space|..)(
        - `productId` string — 상품ID
        - `productName` string — 상품명
        - `productThumbnailUrlList` object[]
          - `isRepresentative` string — 대표여부
          - `thumbnailUrl` string — 썸네일URL
          - `productThumbnailType` string — 썸네일 타입(image|link)
        - `realTimeProductShow` string — 실시간상품노출 여부
        - `redirectUrl` string — 이동URL
        - `sellingPrice` string — 할인가
      - `shopId` string — 상점 ID
      - `explanationHeadline` object — 대표 문구 (라이브 소개 한 줄 요약)
        - `isUsed` boolean — 대표 문구 사용 여부
        - `text` string, nullable — 대표 문구 텍스트
        - `color` string, nullable — 대표 문구 색상
      - `explanationUrl` string — 라이브 소개 본문(HTML)이 담긴 JSON 파일의 CDN URL. 해당 URL로 GET 요청 시 { "html": "..." } 형태의 응답 반환.

## Other responses

- `400` — 400
- `500` — 500

---

[API](https://skmtc.net/sauce/apis/authorize-v2.md) · [All operations](https://skmtc.net/sauce/apis/authorize-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sauce/authorize-v2/revisions/17497c96804d/schema)