---
title: "ver 2026-05-20"
method: POST
path: "/clips/search"
---

# ver 2026-05-20

`POST /clips/search`

2026-05-20 버전의 클립 목록 조건 조회 API입니다.

## Headers

- `Authorization` string, required
- `x-api-version` '2026-05-20'

## Request body

- object
  - `clipIds` integer[] — 조회할 클립 ID 배열 (100개까지 조회 가능)
  - `affiliateProductIds` string[] — 조회할 상품 코드 배열 (100개까지 조회 가능)

## Response `200`

200

- object
  - `timestamp` integer — 타임스탬프
  - `requestId` string — 요청 ID
  - `data` object — 데이터
    - `count` integer — 총 갯수
    - `data` object[] — 데이터
      - `id` integer — 클립 ID
      - `description` string
      - `type` 'clip' | 'reward' | 'advertise' — 클립 타입(clip-클립|reward-리워드|advertise-광고)
      - `state` 'public' | 'private' | 'progress' — 클립 상태(public-공개|private-비공개|progress-변환중)
      - `thumbnailUrl` string — 썸네일 path Url
      - `customThumbnailUrl` unknown
      - `thumbnailType` 'AUTO' | 'CUSTOM' — 썸네일 타입(AUTO-자동추출|CUSTOM-직접 올린 썸네일)
      - `channelName` unknown
      - `channelUrl` unknown
      - `channelThumbnailUrl` unknown
      - `shortUrl` string — 숏링크
      - `previewUrl` string — 미리보기 영상 full url
      - `isChannelUsed` boolean — 채널 사용 여부
      - `isTagUsed` boolean — 태그 사용 여부
      - `curationIds` integer[] — 큐레이션 ID 목록
      - `clipSource` object — 클립 영상 정보
        - `id` integer — 영상 ID
        - `hash` string — 영상 해시
        - `state` 'ready' | 'converting' | 'done' | 'error' — 영상 상태(ready-준비|converting-변환중|done-변환완료|error-에러)
        - `errorCode` unknown
        - `duration` integer — 재생 시간 (초)
        - `size` integer — 파일 사이즈
        - `width` integer — 가로 사이즈
        - `height` integer — 세로 사이즈
        - `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` unknown
        - `discountType` string — 할인 타입
        - `discountRate` string — 할인율
        - `discountPrice` string — 할인된 가격
        - `sellingPrice` string — 최종 할인가
        - `sellingTextPrice` unknown
        - `productStatusCode` string — 상품 상태 코드
        - `redirectUrl` string — 이동할 URL
        - `createdDate` string — 생성 일자
        - `updatedDate` string — 수정 일자
      - `partnerUniqueId` string — 파트너 유니크 ID(문자형)
      - `user` object — 사용자 정보
        - `id` integer — 사용자 ID
        - `name` string — 사용자명
        - `identity` string — 사용자 식별자
        - `partnerAdminUserUniqueId` string — 파트너 어드민 유저 유니크 ID
      - `createdAt` string — 생성 일자
      - `updatedAt` string — 수정 일자
      - `deletedAt` string — 삭제 일자

## Other responses

- `400` — 400
- `401` — 401
- `404` — 404

---

[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)