---
title: "상품 목록 조회"
method: GET
path: "/v2/products"
---

# 상품 목록 조회

`GET /v2/products`

상품 목록 조회 API입니다.

## Query parameters

- `page` string
- `size` string
- `keywordType` 'productName' | 'brandName' | 'affiliateProductId'
- `keywod` string

## Headers

- `x-sauceflex-authorize` string, required

## Response `200`

success

- object
  - `code` string, required — 코드 "0" 일 시 정상 응답
  - `data` object — 데이터
    - `paginationData` object — 페이지네이션 정보
      - `totalCount` number — 전체 데이터 갯수
      - `pageSize` number — 사이즈
      - `currentPage` number — 현재 페이지
      - `totalPage` number — 전체 페이지
    - `products` object[] — 상품 목록
      - `id` number — 상품 아이디(숫자)
      - `productUniqueId` string — 상품 아이디(문자열)
      - `partnerId` number — 파트너 아이디(숫자)
      - `partnerUniqueId` string — 파트너 아이디(문자)
      - `partnerName` string — 파트너명
      - `productThumbnails` object[] — 상품 썸네일 객체
        - `id` string — 상품 썸네일 아이디
        - `isRepresentative` string — 대표 여부
        - `productThumbnailType` string — 썸네일 타입</br> image: 이미지 직접 등록</br> link: 링크로 등록</br>
        - `thumbnailUrl` string — 썸네일 URL
        - `originLinkUrl` string — 원본 링크 URL
      - `redirectUrl` string — 상품 클릭 시 이동할 URL
      - `androidSchemeUrl` string — 안드로이드 스킴 URL
      - `iosSchemeUrl` string — iOS 스킴 URL
      - `brandName` string — 브랜드명
      - `productName` string — 상품명
      - `affiliateProductId` string — 상품 코드
      - `productPriceType` 'basic' | 'text' | 'hide' — 상품 타입</br> basic: 할인가와 함께 표시</br> text: 순수 텍스트만 표시</br> hide: 가격정보 없음</br>
      - `productPrice` string — 상품가
      - `productTextPrice` string — productPriceType 이 text일 시 표현되는 텍스트 상품가
      - `productDiscountType` 'rate' | 'price' | 'none' — 상품 할인 타입</br> rate: 할인율</br> none: 없음</br>
      - `discountRate` string — 할인율
      - `discountPrice` string — 할인된 가격
      - `sellingPrice` string — 최종 할인가
      - `sellingTextPrice` string — 최종 텍스트 할인가
      - `currencyCode` 'KR' | 'US' | 'JP' | 'VN' | 'ID' — 환율 코드 KRW: 대한민국 통화</br> USD: 미국 통화 </br> JPY: 일본 통화</br> VND: 베트남 통화</br> IDR:인도네시아 통화
      - `currencyNotationCode` '₩' | '$' | '₫' | 'Rp' | '¥' — 통화 표기 코드 ₩: 대한민국 원 단위</br> $: 미국 달러 단위</br> ¥: 일본 엔 단위</br> ₫: 베트남 동 단위</br> Rp: 인도네시아 루피아 단위</br>
      - `createdDate` string — 생성일자
      - `createdId` string — 생성자 아이디
      - `createdLoginId` string — 생성자 로그인 아이디
      - `createdName` string — 상성자명
      - `productStatusCode` 'ACTIVE' | 'INACTIVE' | 'SOLD_OUT' — 상품 상태 코드</br> ACTIVE: 활성화</br> INACTIVE: 비활성화</br> SOLD_OUT: 품절</br>
      - `productCreatedSystemCode` 'space' | 'migration' | 'productApi' | 'clip' | 'cafe24' | 'shopby' | 'makeshop' | 'godomall' | 'imweb' | 'crawler' — 상품 생성 시스템 코드</br> space: 어드민에서 직접 생성한 경우</br> migration: 2024.07월 이전에 생성하여 소스클립과 함께 사용한 경우</br> productApi: api로 상품을 만든 경우</br> clip: 2024.07월 이전 소스클립서버에서만 상품을 사용한 경우</br> cafe24: 웹빌더사 cafe24와 연결하여 상품을 조회하여 바로 생성한 경우</br> shopby: 웹빌더사 shopby와 연결하여 상품을 조회하여 바로 생성한 경우</br> makeshop: 웹빌더사 makeshop와 연결하여 상품을 조회하여 바로 생성한 경우</br> godomall: 웹빌더사 godomall와 연결하여 상품을 조회하여 바로 생성한 경우</br> imweb: 웹빌더사 imweb와 연결하여 상품을 조회하여 바로 생성한 경우</br> crawler: 어드민에서 크롤링기능을 이용하여 상품을 생성한 경우</br>
      - `updatedDate` string — 수정 일
      - `updatedId` string — 수정자 아이디
      - `updatedLoginId` string — 수정자 로그인 아이디
      - `updatedName` string — 수정자명

## Other responses

- `400` — Bad Request
- `403` — Forbidden

---

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