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

상품 목록 구간 조회

# 01

요약

API 적용 가능한 구매자 사용자 지역: 한국,대만 등록된 상품 목록을 생성일시 기준으로 조회한다. 최대 조회 범위는 10분입니다.

# 02

상세

API 적용 가능한 구매자 사용자 지역: 한국,대만
등록된 상품 목록을 생성일시 기준으로 조회한다.
최대 조회 범위는 10분입니다.

Path

GET

/v2/providers/seller_api/apis/api/v1/marketplace/seller-products/time-frame

Example Endpoint

https://api-gateway.coupang.com/v2/providers/seller_api/apis/api/v1/marketplace/seller-products/time-frame?vendorId=A00012345&createdAtFrom=2020-02-19T10:43:30&createdAtTo=2020-02-19T10:50:30

Request Parameters

Query String Parameter

Name Required Type Description
vendorId O String
판매자 ID
쿠팡에서 업체에게 발급한 고유 코드
예) A00012345
createdAtFrom O String
생성 시작일시
"yyyy-MM-ddTHH:mm:ss" 형식
예) 2016-12-28T06:20:00
createdAtTo O String
생성 종료일시
"yyyy-MM-ddTHH:mm:ss" 형식
예) 2016-12-28T06:20:00

Request Example

not require body

Response Message

Name Type Description
code Number
결과코드
SUCCESS/ERROR
message String
결과 메세지
data  
등록상품목록
조회된 업체상품 개수만큼 N번 반복
  sellerProductId Number
등록상품ID
  sellerProductName String
등록상품명
등록상품명 검색. 20자 이하
  displayCategoryCode Number
노출카테고리코드
  vendorId String
판매자 ID
쿠팡에서 업체에게 발급한 고유 코드
예) A00012345
  saleStartedAt String
판매시작일시
"yyyy-MM-ddTHH:mm:ss" 형식
  saleEndedAt String
판매종료일시
"yyyy-MM-ddTHH:mm:ss" 형식
  brand String
브랜드
브랜드명은 한글/영어 표준이름 입력
  statusName String
등록상품 상태명
Parameter Name Status
IN_REVIEW 심사중
SAVED 임시저장
APPROVING 승인대기중
APPROVED 승인완료
PARTIAL_APPROVED 부분승인완료
DENIED 승인반려
DELETED 상품삭제
  createdAt String
판매등록일시
"yyyy-MM-ddTHH:mm:ss" 형식

Response Example

{
  "code": "SUCCESS",
  "message": "",
  "data": [
    {
      "sellerProductId": 123,
      "sellerProductName": "[인xx] 컴퓨터잡지",
      "displayCategoryCode": null,
      "categoryId": 5555,
      "productId": 3333,
      "vendorId": "A0xxxxx",
      "mdId": "jxxx@",
      "mdName": "박xxx",
      "saleStartedAt": "2015-12-28T06:00:00",
      "saleEndedAt": "2099-01-01T00:00:00",
      "brand": null,
      "statusName": "승인완료",
      "createdAt": "2015-12-28T18:57:34"
    }
  ]
}

Error Spec

HTTP 상태 코드 (오류 유형) 오류 메시지 해결 방법
400 (요청변수확인) 업체[A0012345]는 다른 업체[skma***]의 상품목록을 조회할 수 없습니다. 판매자ID(vendorId)를 올바로 입력했는지 확인합니다.
400 (요청변수확인)

검색 허용 범위를 초과했습니다. 최대 허용 범위는 10분입니다.

 조회 시작일(createdAtFrom)과 종료일(createdAtTo)을 올바로 입력했는지 확인합니다. 최대 10분 이내만 조회가 가능합니다.

URL API Name

GET_PRODUCTS_BY_TIME_FRAME