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

# 예정 라이브 조회

`GET /V1/front/broadcast/schedule`

## Request

- Base URL: `https://stage.api.sauceflex.com`
- URL: `https://stage.api.sauceflex.com/V1/front/broadcast/schedule`
- Auth: none required

예정 라이브 조회 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.dev/sauce/apis/saucelive.md) - [All operations](https://skmtc.dev/sauce/apis/saucelive/llms.txt) - [OpenAPI document](https://skmtc.dev/sauce/apis/saucelive/revisions/d9e8f0fce2cc?raw)