---
title: "최신 라이브 및 VOD 조회"
method: GET
path: "/V1/front/broadcast"
---

# 최신 라이브 및 VOD 조회

`GET /V1/front/broadcast`

최신 라이브 및 VOD 조회 API입니다.

## Query parameters

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

## Response `200`

200

- object
  - `code` string — 응답 코드
  - `timestamp` number — 타임스탬프
  - `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 — 방송명
      - `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` object[] — 송출 정보
        - `preview` string — 미리보기 경로
        - `bucketName` string — 버킷명
        - `cloudFront` string — cf명
        - `path` string — 경로
        - `downloadUrl` string — 다운로드 경로
        - `type` string — 타입
        - `keyPrefix` string — 프리픽스 키
        - `key` 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` boolean — 대표 여부
        - `isVod` boolean — VOD 여부
        - `thumbnailUrl` string — 썸네일URL
      - `useNotification` boolean — 알림 사용 여부
      - `usePurchaseEvent` boolean — 구매인증 이벤트 사용 여부
      - `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` boolean — 품절 여부
        - `languageTag` string — 언어 태그
        - `ord` string — 정렬 순서
        - `price` string — 가격
        - `priceTypeCode` string — 가격정보구분코드(basic|text|hide)
        - `productCreadtedSystemCode` string — 상품 생성 코드(space|..)(
        - `productId` string — 상품ID
        - `productName` string — 상품명
        - `productThumbnailUrlList` object[]
          - `isRepresentative` boolean — 대표여부
          - `thumbnailUrl` string — 썸네일URL
          - `productThumbnailType` string — 썸네일 타입(image|link)
        - `realTimeProductShow` boolean — 실시간상품노출 여부
        - `redirectUrl` string — 이동URL
        - `sellingPrice` string — 할인가
      - `previewUrl` string — 미리보기 URL
      - `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)