---
title: "ver 2026-04-29"
method: GET
path: "/clip/{clipId}"
---

# ver 2026-04-29

`GET /clip/{clipId}`

## Request

- Base URL: `https://stage.api.sauceclip.com`
- URL: `https://stage.api.sauceclip.com/clip/{clipId}`
- Auth: none required

2026-04-29 버전의 클립 상세 조회 API입니다.

## Path parameters

- `clipId` integer, required

## Headers

- `x-api-version` '2026-04-29'
- `authorization` string, required

## Response `200`

200

- object
  - `timestamp` integer: 타임스탬프
  - `requestId` string: 요청 ID
  - `data` object: 응답 데이터
    - `id` integer: 클립 ID
    - `description` string: 클립 설명
    - `type` 'clip' | 'reward' | 'advertise': 클립 타입 clip-클립 reward-리워드
    - `state` 'public' | 'private': 클립 상태 public-공개 private-비공개
    - `thumbnailUrl` string: 썸네일 path URL
    - `customThumbnailUrl` string: 커스텀 썸네일 path URL
    - `thumbnailType` string: 썸네일 타입 AUTO-자동추출 CUSTOM-직접 업로드
    - `channelName` string: 채널명
    - `channelUrl` string: 채널 클릭 시 이동할 URL
    - `channelThumbnailUrl` string: 채널 썸네일 full URL
    - `isChannelUsed` boolean: 채널 사용 여부
    - `isTagUsed` boolean: 태그 사용 여부
    - `isCommentUsed` boolean: 댓글 사용 여부
    - `displayStartedAt` string: 공개 시작 일자 (null인 경우 무제한)
    - `displayEndedAt` string: 공개 종료 일자 (null인 경우 무제한)
    - `shortUrl` string: 클립 플레이어 숏링크
    - `previewUrl` string: 미리보기 영상 full URL
    - `resourceUrl` string: 리소스 CDN URL
    - `partnerUniqueId` string: 파트너 유니크 ID
    - `createdAt` string: 생성 일자
    - `updatedAt` string: 수정 일자
    - `clipSource` object: 클립 영상 정보
      - `id` integer: 영상 ID
      - `hash` string: 영상 해시
      - `state` 'ready' | 'converting' | 'done' | 'error': 영상 상태 ready-준비 converting-변환중 done-변환완료 error-에러
      - `errorCode` string: 에러 코드
      - `duration` integer: 재생 시간 (초)
      - `size` integer: 파일 사이즈 (bytes)
      - `width` integer: 가로 사이즈 (px)
      - `height` integer: 세로 사이즈 (px)
      - `previewKey` string: 미리보기 path
      - `key` string: 영상 path
      - `createdAt` string: 생성 일자
    - `clipTags` object[]: 클립 태그 목록
      - `id` integer: 태그 ID
      - `tag` string: 태그명
    - `products` object[]: 상품 목록
      - `productId` integer: 상품 ID
      - `productUniqueId` string: 상품 유니크 ID
      - `affiliateProductId` string: 외부 상품 코드
      - `productName` string: 상품명
      - `brandName` string: 브랜드명
      - `countryCode` 'KR' | 'US' | 'JP' | 'VN' | 'ID': 국가 코드 KR: 대한민국 통화 코드</br> US: 미국 통화 코드</br> JP: 일본 통화 코드</br> VN: 베트남 통화 코드</br> ID: 인도네시아 통화 코드</br>
      - `currencyCode` 'KR' | 'US' | 'JP' | 'VN' | 'ID': 환율 코드 KRW: 대한민국 통화</br> USD: 미국 통화 </br> JPY: 일본 통화</br> VND: 베트남 통화</br> IDR:인도네시아 통화
      - `currencyNotationCode` '₩' | '$' | '₫' | 'Rp' | '¥': 통화 표기 코드 ₩: 대한민국 원 단위</br> $: 미국 달러 단위</br> ¥: 일본 엔 단위</br> ₫: 베트남 동 단위</br> Rp: 인도네시아 루피아 단위</br>
      - `price` string: 판매가
      - `textPrice` string: 텍스트 판매가
      - `discountType` string: 할인 타입
      - `discountRate` string: 할인율
      - `discountPrice` string: 할인된 가격
      - `sellingPrice` string: 최종 할인가
      - `sellingTextPrice` string: 텍스트 할인가
      - `productStatusCode` string: 상품 상태 코드
      - `redirectUrl` string: 상품 클릭 시 이동할 URL
      - `createdDate` string: 생성 일자
      - `updatedDate` string: 수정 일자
    - `reward` object: 리워드 정보 (리워드 클립인 경우)
      - `id` integer: 리워드 ID
      - `type` string: 리워드 타입
      - `isDisplayOnExhausted` boolean: 리워드 소진 시 노출 여부
      - `isExhausted` boolean: 리워드 소진 여부
      - `totalAmount` integer: 총 리워드 금액
      - `paidAmount` integer: 지급된 리워드 금액
      - `conditionTime` integer: 조건 시간 (초)
      - `conditionAmount` integer: 조건 금액
      - `payUnit` string: 지급 단위
      - `firstAchieveDate` string: 최초 달성 일자
      - `lastAchieveDate` string: 최종 달성 일자
      - `createdAt` string: 생성 일자

## Other responses

- `401`: 401
- `404`: 404

---

[API](https://skmtc.dev/sauce/apis/sauceclip.md) - [All operations](https://skmtc.dev/sauce/apis/sauceclip/llms.txt) - [OpenAPI document](https://skmtc.dev/sauce/apis/sauceclip/revisions/f85dc9812369?raw)