Products Retrieval

imageUrl 생성 방법

imageUrlTemplate의 {cnt}를 imageCount로 치환하여 사용한다.

Example:

{
  "data": [
    {
      "pid": 2000614090,
      ...
      "imageUrlTemplate": "https://media.bunjang.co.kr/product/2000614090_{cnt}_1737447450_w640.jpg",
      "imageCount": 3,
      ...
    },
    ...
  ],
  ...
}

치환결과

https://media.bunjang.co.kr/product/2000614090_1_1737447450_w640.jpg

https://media.bunjang.co.kr/product/2000614090_2_1737447450_w640.jpg

https://media.bunjang.co.kr/product/2000614090_3_1737447450_w640.jpg

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

size

integer

optional

max size 100 (default 100)

Example:

100

sort

string

optional

score: 정확도순 (검색어 필수) default
latest: 최근등록순
price_asc: 낮은가격순
price_desc: 높은가격순

Example:

score

cursor

string

optional

Next page cursor. 이전 리스트의 nextCursor 값을 변조없이 전달

Example:

[0.074820995,1721693446483,2000150271]

string

optional

검색어

Example:

nike

categoryId

string

optional

카테고리 필터. comma 구분으로 다중 카테고리 검색 가능.

Example:

400,410

brandId

integer

optional

브랜드 필터. comma 구분으로 다중 브랜드 검색 가능.

Example:

1,2,3

freeShipping

boolean

optional

무료배송 필터

Example:

true

maxPrice

integer

optional

최대 금액 필터

Example:

1000000

minPrice

integer

optional

최소 금액 필터

Example:

50000

canInstantTrade

boolean

optional

즉시거래 가능여부 필터

Example:

true

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Body

data

array [object {16}]

optional

pid

integer

required

name

string

required

quantity

integer

required

price

integer

required

shippingFee

integer

required

condition

string

required

saleStatus

string

required

keywords

string

optional

imageUrlTemplate

string

required

imageCount

integer

required

categoryId

string

required

brandId

integer

optional

options

array [object {2}]

optional

uid

integer

required

updatedAt

string

required

createdAt

string

required

nextCursor

string

optional

hasNext

boolean

required

Example

{
    "data": [
        {
            "pid": 2000614090,
            "name": "샤넬 테스트 ms",
            "quantity": 1,
            "price": 1100000,
            "shippingFee": 0,
            "condition": "LIKE_NEW",
            "saleStatus": "SELLING",
            "keywords": "샤넬",
            "imageUrlTemplate": "https://media.bunjang.co.kr/product/2000614090_{cnt}_1737447450_w640.jpg",
            "imageCount": 1,
            "categoryId": "310260800",
            "brandId": 41,
            "options": [
                {
                    "id": "사이즈",
                    "value": "Free"
                }
            ],
            "uid": 2000004443,
            "updatedAt": "2025-01-20T23:17:30Z",
            "createdAt": "2025-01-20T23:17:30Z"
        },
        {
            "pid": 2000614054,
            "name": "샤넬 코코크러쉬 브레이슬릿 테스트",
            "quantity": 1,
            "price": 8000000,
            "shippingFee": 0,
            "condition": "NEW",
            "saleStatus": "SELLING",
            "imageUrlTemplate": "https://media.bunjang.co.kr/product/2000614054_{cnt}_1737364347_w640.jpg",
            "imageCount": 1,
            "categoryId": "422300100",
            "brandId": 41,
            "uid": 2000009345,
            "updatedAt": "2025-01-20T00:12:27Z",
            "createdAt": "2025-01-16T21:13:01Z"
        }
    ],
    "nextCursor": "[0.14971776,1733362477262,2000613432]",
    "hasNext": true
}

🟠401INVALID_AUTH_TOKEN

🟠400BAD_REQUEST

imageUrl 생성 방법#

Request

Request samples

Responses

imageUrl 생성 방법