coupang
API 문서
상품 API카테고리 API브랜드 API배송 / 주문 API반품 API교환 API프로모션 / 쿠폰물류 정보고객 문의정산CGF / CGF liteRocket Growth
GET/v2/providers/seller_api/apis/api/v1/marketplace/seller-products2609170000

상품 목록 페이징 조회

KRTW
# 01

요약

상품 목록 페이징 조회

# 02

상세

API 적용 가능한 구매자 사용자 지역: 한국，대만

등록상품 목록을 페이징 조회한다.

경로

GET/v2/providers/seller_api/apis/api/v1/marketplace/seller-products

예시 엔드포인트

https://api-gateway.coupang.com/v2/providers/seller_api/apis/api/v1/marketplace/seller-products?vendorId={vendorId}&nextToken={nextToken}&maxPerPage={maxPerSize}&sellerProductId={sellerProductId}&sellerProductName={sellerProductName}&status={status}&manufacture={manufacture}&createdAt={createdAt}&violationTypes=ATTR&violationTypes=MOTA_V2&violationTypeAndOr=OR

URL API Name

GET_PRODUCTS_BY_QUERY
# 03

Query 파라미터

NameTypeDescription
vendorId*string
판매자 ID
쿠팡에서 업체에게 발급한 고유 코드
예) A00012345
nextTokennumber
페이지
다음 페이지를 호출하기 위한 키값. 첫 페이지 호출시에는 넣지 않거나 1 입력
maxPerPagenumber
페이지당건수
기본값 : 10, 최대값 :100
sellerProductIdnumber
등록상품ID
sellerProductNamestring
등록상품명
등록상품명 검색. 20자 이하
statusstring
업체상품상태
Parameter Name Status
IN_REVIEW 심사중
SAVED 임시저장
APPROVING 승인대기중
APPROVED 승인완료
PARTIAL_APPROVED 부분승인완료
DENIED 승인반려
DELETED 상품삭제
manufacturestring
제조사
createdAtstring
상품등록일시
"yyyy-MM-dd" 형식
예)2015-12-17과 같이 입력하면, 2015-12-17T00:00:00 ~ 2015-12-17T23:59:59 와 같이 조회됨
ViolationTypeSearchFieldarray
  • NO_VA_V2: 상품정보 검증이 필요한 상품 (노출제한)
  • MOTA_V2: 누락된 필수 구매옵션을 입력해야하는 상품 (노출제한)
  • ATTR: 옵션 수정이 필요한 상품 (노출낮음)
ViolationTypeAndOrstring
설명: "ViolationTypeSearchField" 필드에 2개 이상의 파라미터를 입력하는 경우 필수입니다.

값:
  • AND
  • OR
# 04

응답 본문

응답 메시지

NameTypeDescription
codestring
결과코드
SUCCESS/ERROR
messagestring
결과 메세지
nextTokenstring
다음페이지
만약 다음 페이지가 없을 경우 빈문자열
dataobject[]
sellerProductId
data[].sellerProductId
integer
등록상품ID
sellerProductName
data[].sellerProductName
string
등록상품명
displayCategoryCode
data[].displayCategoryCode
integer
노출카테고리코드
categoryId
data[].categoryId
integer
카테고리아이디
productId
data[].productId
integer
ProductID
vendorId
data[].vendorId
string
판매자ID
saleStartedAt
data[].saleStartedAt
string
판매시작일시
"yyyy-MM-ddTHH:mm:ss" 형식
saleEndedAt
data[].saleEndedAt
string
판매종료일시
"yyyy-MM-ddTHH:mm:ss" 형식
brand
data[].brand
string
브랜드
statusName
data[].statusName
string
등록상품상태
Parameter Name Status
IN_REVIEW 심사중
SAVED 임시저장
APPROVING 승인대기중
APPROVED 승인완료
PARTIAL_APPROVED 부분승인완료
DENIED 승인반려
DELETED 상품삭제
Parameter NameStatus
IN_REVIEW심사중
SAVED임시저장
APPROVING승인대기중
APPROVED승인완료
PARTIAL_APPROVED부분승인완료
DENIED승인반려
DELETED상품삭제
createdAt
data[].createdAt
string
판매등록일시
"yyyy-MM-ddTHH:mm:ss" 형식

Response Example

{
  "code": "SUCCESS",
  "message": "",
  "nextToken": "2",
  "data": [
    {
      "sellerProductId": 239092172,
      "sellerProductName": "R07 헬로키티 미니낚시놀이",
      "displayCategoryCode": 77413,
      "categoryId": 2102,
      "productId": 14784194,
      "vendorId": "XXXXXXXX",
      "mdId": "harry867@",
      "mdName": null,
      "saleStartedAt": "2017-02-14T06:00:00",
      "saleEndedAt": "2099-12-31T00:00:00",
      "brand": "상세설명별도참조",
      "statusName": "승인완료",
      "createdAt": "2017-02-13T02:09:47"
    },
    {
      "sellerProductId": 239092161,
      "sellerProductName": "R07 러닝리소스 손가락 지시봉 (10개 세트) (LER2657) - 러닝리소스 지시봉 손가락 포인터 장난감",
      "displayCategoryCode": 77413,
      "categoryId": 2102,
      "productId": 14784126,
      "vendorId": "XXXXXXXX",
      "mdId": "harry867@",
      "mdName": null,
      "saleStartedAt": "2017-02-14T06:00:00",
      "saleEndedAt": "2099-12-31T00:00:00",
      "brand": "상세설명별도참조",
      "statusName": "승인완료",
      "createdAt": "2017-02-13T02:09:46"
    }
  ]
}
# 05

에러 코드

HTTP코드메시지
400HTTP_400Bad Request

오류 사양

HTTP유형오류 메시지해결 방법
400400 (요청변수확인)

업체코드는 반드시 입력되어야 합니다.

판매자 ID(vendorId) 값을 올바로 입력했는지 확인합니다.

400400 (요청변수확인)

Format of createdAt is yyyy-MM-dd

상품등록일시(createdAt) 값을 올바른 형식으로 입력했는지 확인합니다. "yyyy-MM-dd" 형식으로 입력합니다.