Imweb
Search
⌃K

상품 조회

get
https://api.imweb.me/v2/shop/products/
{상품번호}
상품번호를 입력하지 않으면 전체 상품 목록을 조회합니다.

상품 목록 요청 데이터

항목
타입
설명
prod_status
string
특정 상태의 상품을 조회할 때 입력합니다.
상품 상태 종류
  • sale: 판매중
  • soldout: 품절
  • nosale: 숨김
category
string
상품 카테고리 코드 상품 카테고리 조회

응답 데이터

기본 응답 데이터

항목
타입
설명
no
Integer
상품번호
prod_status
String
상품 상태
  • sale: 판매중
  • soldout: 품절
  • nosale: 숨김
categories
Array
카테고리 코드 목록
custom_prod_code
String
자체 상품코드
name
String
상품명
images
Array
이미지 파일 코드
image_url
Array
이미지 파일 URL
content
String
상세설명
simple_content
String
요약 설명
use_mobile_prod_content
Boolean
모바일 상세설명 사용 유무
mobile_content
String
모바일 상세 설명
prod_type
String
판매 방식 설정
  • normal: 일반 상품
  • digital: 디지털 상품세부 정보는 prod_type_data 참고
  • subscribe: 회원그룹 이용권세부 정보는 prod_type_data 참고
prod_type_data
Array
판매 방식 데이터
prod_type 형식에 맞는 데이터를 전달해주세요.
use_pre_sale
Boolean
판매기간 설정 여부
pre_sale_start_date
Integer
판매기간 시작일(Timestamp)
pre_sale_end_date
Integer
판매기간 종료일(Timestamp)
price
Float
상품가격
price_org
Float
할인 이전 가격
price_tax
Boolean
세금 포함 여부
price_none
Boolean
가격 없음 여부
point
Array
적립금 설정 (PointConfigData)
product_discount_options
Array
할인 사용 설정
  • coupon: 쿠폰
  • point: 적립금
  • shopping_group_dc: 쇼핑등급 할인
weight
Float
상품 무게
stock
Array
상품 재고 정보
옵션 재고 정보는 옵션 정보를 참고해주세요. (ProdStockConfigData)
origin
String
원산지
maker
String
제조사
brand
String
브랜드
badge
Array
뱃지 정보 (ProdBadgeData)
seo
Array
SEO 관련 정보 (ProdSeoData)
sync
Array
외부 연동용 정보(ProdSyncData)
etc
Array
기타설정 (ProdEtcData)
prodinfo
Array
상품정보제공고시
is_exist_options
String
상품의 옵션 유무
  • Y: 옵션이 존재
  • N: 단일 상품
is_mix
String
상품의 조합형 옵션 여부
  • Y: 조합형 옵션
  • N: 단일 옵션
add_time
Integer
상품 추가시간 Timestamp
edit_time
Integer
상품 최근 수정시간 Timestamp

prod_type_data - Digital Data

항목
타입
설명
use_limit
Boolean
다운로드 한도 설정
period
Integer
기간 제한
maximum
Integer
횟수 제한

prod_type_data - Subscribe Data

항목
타입
설명
group_code
String
대상 그룹 코드
period
Integer
그룹 유지 기간(일)

Point Config Data

항목
타입
설명
type
String
적립금 설정 타입
  • common: 기본 설정을 따름
  • individual: 개별 적립금 설정
value_type
String
적립금 적립 단위
  • percent: 퍼센트
  • price: 통화 단위
value
String
적립금 값
적립금 단위가 퍼센트일 경우 백분율로 계산

Period Discount Data

항목
타입
설명
group_type
String
할인적용대상
  • 회원+비회원
  • 회원
  • 그룹 명
dc_price
String
할인 금액
단위가 퍼센트일 경우 백분율로 계산
dc_type
String
할인금액 단위
  • percent: 퍼센트
  • price: 통화 단위

ProdStockConfig Data

항목
타입
설명
stock_use
Boolean
재고 사용여부
stock_unlimit
Boolean
재고 소진 후 주문 가능 여부
stock_no_option
Integer
상품 재고 수량
sku_no_option
Integer
상품 재고번호(SKU)

ProdBadge Data

항목
타입
설명
new
Boolean
뱃지 - 신상품 여부
best
Boolean
뱃지 - 베스트 여부
md
Boolean
뱃지 - MD 추천 여부
hot
Boolean
뱃지 - 주문폭주 여부

ProdSeoData Data

항목
타입
설명
seo_title
String
SEO 제목
seo_description
String
SEO 설명
seo_access_bot
Boolean
SEO 검색엔진 접근 제외 유무

ProdSyncData Data

항목
타입
설명
pay_product_name
String
네이버, 카카오 쇼핑 노출용 상품명
event_words
String
네이버 쇼핑 이벤트 문구
naver_category
String
네이버 쇼핑 카테고리 ID
product_flag
String
네이버 쇼핑 판매 방식
  • 소매
  • 도매
  • 렌탈
  • 대여
  • 할부
  • 예약판매
  • 구매대행
product_condition
String
네이버 쇼핑 상품상태
  • 신상품
  • 중고
  • 리퍼
  • 전시
  • 반품
  • 스크래치
import_flag
Boolean
해외구매대행 여부
parallel_import
Boolean
병행수입 여부
is_culture_benefit
Boolean
도서공연비 소득공제
order_made
Boolean
주문제작 여부

ProdEtcData Data

항목
타입
설명
minimum_purchase_quantity
Integer
최소 구매 수량
maximum_purchase_quantity
Integer
1회 구매 시 최대 수량
member_maximum_purchase_quantity
Integer
1인 구매 시 최대 수량
optional_limit_type
String
0원 선택옵션 구매 시 최대 구매수량 제한 타입
  • relative: 본상품 구매 수량만큼 구매 가능
  • limit: 최대 구매 수량 제한
  • unique: 1개만 구매 가능
optional_limit
Integer
0원 선택옵션 구매 시 최대 구매수량 - 최대 구매 수량 제한
use_unipass_number
String
개인통관고유부호 사용 설정
  • default: 기본 방법을 따름 (쇼핑 환경설정)
  • Y: 사용
  • N: 사용안함
adult
Boolean
미성년자 구매 제한