---
title: "ver 큐레이션 목록 조회(by curationIds)"
method: POST
path: "/v2/curations/search"
---

# ver 큐레이션 목록 조회(by curationIds)

`POST /v2/curations/search`

## Request

- Base URL: `https://stage.api.sauceclip.com`
- URL: `https://stage.api.sauceclip.com/v2/curations/search`
- Auth: none required

헤더에 버전을 명시하지 않은 큐레이션 목록 조회(by curationIds) API입니다.

## Headers

- `Authorization` string, required

## Request body

- object
  - `curationIds` integer[]: 조회할 큐레이션 ID 배열 (100개까지 조회 가능)

## Response `200`

200

- object
  - `timestamp` integer: 타임스탬프
  - `requestId` string: 요청 ID
  - `data` object: 데이터
    - `count` integer: 총 갯수
    - `data` object[]: 데이터
      - `id` integer: 큐레이션 ID
      - `name` string: 이름
      - `isNameVisible` boolean: 이름 표시 여부
      - `description` string, nullable: 설명
      - `isDescriptionVisible` boolean: 설명 표시 여부
      - `orderType` 'ord' | 'random': 정렬 기준 타입(ord-지정 순서|random-랜덤)
      - `orderSortType` 'sortNoAsc' | 'pvAsc' | 'pvDesc' | 'createdAtAsc' | 'createdAtDesc': 정렬 방향(sortNoAsc-지정순|pvAsc-조회순↑|pvDesc-조회순↓|createdAtAsc-생성순↑|createdAtDesc-생성순↓)
      - `viewType` 'grid' | 'carousel' | 'scroll': 뷰 타입(grid-그리드|carousel-캐러셀|scroll-스크롤)
      - `playType` 'cursor' | 'not' | 'auto': 재생 타입(cursor-커서|not-사용안함|auto-자동재생)
      - `isDisplayProductVisible` boolean: 상품 표시 여부
      - `isPageViewCountVisible` boolean: 페이지뷰 카운트 표시 여부
      - `isPlayButtonVisible` boolean: 재생 버튼 표시 여부
      - `isBrandNameVisible` boolean: 브랜드명 표시 여부
      - `state` 'public' | 'private': 큐레이션 상태(public-공개|private-비공개)
      - `sortNo` integer: 정렬 순서
      - `clipList` object[]: 큐레이션에 포함된 클립 목록
        - `clipId` integer: 클립 ID
        - `sortNo` integer: 정렬 순서
      - `partnerUniqueId` string: 파트너 유니크 ID(문자형)
      - `createdAt` string: 생성 일자
      - `deletedAt` 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)