---
title: "전시 클립 목록 조회"
method: GET
path: "/v2/display/clips"
---

# 전시 클립 목록 조회

`GET /v2/display/clips`

헤더에 버전을 명시하지 않은 전시 클립 목록 조회 API입니다.

## Query parameters

- `curationId` integer, required
- `limit` integer
- `page` integer

## Headers

- `Authorization` string, required

## Response `200`

200

- object
  - `timestamp` integer — 타임스탬프
  - `requestId` string — 요청 ID
  - `data` object — 응답 데이터
    - `count` integer — 총 갯수
    - `page` integer — 현재 페이지
    - `limit` integer — 페이지 당 데이터갯수
    - `rows` object[] — 목록
      - `id` integer — 클립 ID
      - `description` string — 클립 설명
      - `type` 'clip' | 'reward' | 'advertise' — 클립 타입(clip-클립|reward-리워드|advertise-광고)
      - `state` 'public' | 'private' | 'progress' — 클립 상태(public-공개|private-비공개|progress-변환중)
      - `displayStartedAt` string — 공개 시작 일자 (null인경우 무제한)
      - `displayEndedAt` string — 공개 종료 일자 (null인경우 무제한)
      - `thumbnailUrl` string — 썸네일 path Url
      - `customThumbnailUrl` string — 커스텀 썸네일 path url
      - `thumbnailType` 'AUTO' | 'CUSTOM' — 썹네일 타입(AUTO-자동추출|CUSTOM-직접 올린 썸네일)
      - `channelName` string — 채널명
      - `channelUrl` string — 채널 클릭 시 이동할 채널 url
      - `channelThumbnailUrl` string — 채널 썸네일 full url
      - `isRewardLocked` boolean — 리워드인 경우 리워드 소진 시 클립 공개 여부
      - `isChannelUsed` boolean — 채널 사용 여부
      - `isTagUsed` boolean — 태그 사용 여부
      - `partnerUniqueId` string — 파트너 유니크 ID(문자형)
      - `partnerAdminUserUniqueId` string — 파트너 어드민 유저 유니크 ID
      - `serviceAdminId` string — 관리자 ID
      - `serviceManagerId` string — 매니져 ID
      - `serviceOperatorId` string — 운영자 ID
      - `createdAt` string — 생성 일자
      - `updatedAt` string — 수정 일자
      - `clipInformationId` integer — 클립 부가 정보 ID
      - `clipSourceId` integer — 클립 영상 ID
      - `rewardId` number — 리워드 ID
      - `clipSource` object — 클립 영상 정보
        - `id` integer — 영상 ID
        - `hash` string — 영상 해시
        - `state` 'ready' | 'converting' | 'done' | 'error' — 영상 상태(ready-준비|converting-변환중|done-변환완료|error-에러)
        - `errorCode` string — 에러 코드(1021,1020 등의 숫자형식의 에러 코드)
        - `duration` integer — 재생 시간 (초)
        - `size` integer — 사이즈
        - `width` integer — 가로 사이즈
        - `height` integer — 세로 사이즈
        - `previewKey` string — 미리보기 path
        - `key` string — 영상 path
        - `progress` integer — 변환 진행률 (0.0 ~ 1.0까지)
        - `eta` number — 예상 변환 종료시간 (소수점 단위 초)
        - `createdAt` string — 생성일
        - `updatedAt` string — 수정일
        - `deletedAt` string — 삭제일
        - `previewUrl` string — 미리보기 영상 full url
        - `clipSourceUrl` string — 영상 full url
      - `clipInformation` object — 클립 부가 정보
        - `id` integer — 클립 정보 ID
        - `pv` integer — 페이지 뷰 카운팅
        - `click` integer — 클릭 키운팅
        - `like` integer — 좋아요 카운팅
      - `curationClips` object — 큐레이션 클립 여부
        - `sortNo` integer — 정렬 순서
        - `createdAt` string — 생성일
        - `updatedAt` string — 수정일
        - `curationId` integer — 큐레이션 ID
        - `clipId` integer — 클립ID
      - `product` object — 첫번째 상품 객체
        - `clipId` integer — 클립ID
        - `productId` integer — 품ID
        - `productUniqueId` string — 상품 유니크 ID
        - `partnerId` integer — 파트너 ID(숫자형)
        - `affiliateProductId` string — 외부 상품 코드
        - `productName` string — 상품명
        - `brandName` string — 브랜드명
        - `productPriceType` 'basic' | 'text' | 'hide' — 상품 타입</br> basic: 할인가와 함께 표시</br> text: 순수 텍스트만 표시</br> hide: 가격정보 없음</br>
        - `price` string — 판매가
        - `textPrice` string — 텍스트 판매가
        - `discountType` string — 할인타입(현재 미사용으로 전부 rate로 반환)
        - `discountRate` string — 할인율
        - `discountPrice` string — 할인된 가격
        - `sellingPrice` string — 할인가
        - `sellingTextPrice` string — 텍스트 할인가
        - `redirectUrl` string — 이동할 URL
        - `createdSystemCode` string — 상품 등록 방식space-직접등록|...)
        - `createdId` string — 생성자ID
        - `createdName` string — 생성자명
        - `createdDate` string — 생성일자
        - `updatedId` string — 수정자ID
        - `updatedName` string — 수정자
        - `updatedDate` string — 수정일자
        - `thumbnailUrl` string — 상품 썸네일 full url
      - `shortUrl` string — 숏링크
      - `clipTags` object[] — 클립 태그 목록
        - `id` integer — 태그 ID
        - `tag` string — 태그명
        - `createdAt` string — 생성일
        - `updatedAt` string — 수정일
        - `deletedAt` string — 삭제일
        - `clipsToTags` object — 클립-태그 연결 정보
          - `createdAt` string — 생성일
          - `updatedAt` string — 수정일
          - `clipId` integer — 클립ID
          - `clipTagId` integer — 클립태그ID
      - `thumbnailFullUrl` string — 클립 썸네일 full url
      - `customThumbnailFullUrl` string — 커스텀 클립 썸네일 full url

## Other responses

- `400` — 400

---

[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/versions/17497c96804d/schema)