Bunjang Open API
  1. Product Catalog
Bunjang Open API
  • Overview
  • Changelog
  • Authentication
  • Product Catalog
    • Service Base URL
    • Sample Data
    • Full Catalog Download
      GET
    • Segment Catalog Download
      GET
  • Rest API
    • Service Base URL
    • Error Codes
    • Product Category
      • Categories Lookup
    • Brand
      • Brands Lookup
    • Product
      • Product Lookup
      • Products Retrieval
    • Point
      • Point Balance Lookup
    • Order
      • Create Order
      • Confirm Order
      • Order Lookup
      • Orders Lookup
      • Create Order V2
  1. Product Catalog

Segment Catalog Download

GET
https://outbound-catalog.bunjang.io/catalog/segment/{filename}

시간별 업데이트 상품 데이터 다운로드#

시간별 업데이트 상품 데이터를 다운로드 받을 수 있다.#


파일 생성 시각: 매시간 10분 (00:10, 01:10, 02:10 ...)
파일명 규칙: segment-{yyyyMMdd_HH}.csv.gz
csv 포맷이며, gzip 압축이 적용되어 있다.
파일이 없는 경우 1분 단위로 재요청한다.

Catalog 파일 포맷#

FieldDescriptionExample
pid상품ID286843781
name상품명에이수스 게이밍 노트북
description상품설명미사용 노트북 팝니다.
배송비 4000원.
quantity수량1
price가격1500000
shipppingFee배송비 (무료배송:0)4000
condition상품상태
- NEW(새상품)
- LIKE_NEW(사용감 없음)
- LIGHTLY_USED(사용감 적음)
- HEAVILY_USED(사용감 많음)
- DAMAGED(고장/파손)
- USED(중고)		LIKE_NEW
saleStatus판매상태
- SELLING(판매중)
- DELETED(상품이 보여지면 안되는 상태)		SELLING
canInstantTrade즉시거래 가능 여부true
keywords상품태그노트북,에이수스
images이미지 URL (comma로 구분)https://media.bunjang.co.kr/product/286843781_1_1724935891_w900.jpg,
https://media.bunjang.co.kr/product/286843781_2_1724935891_w900.jpg
categoryId카테고리ID600100001
brandId브랜드ID110
options옵션정보(JSON)[{ "id": "저장용량", "value": "128GB" }, { "id": "램 용량", "value": "기타 (상품설명에 작성)"}]
uid상점ID83370995
updatedAt수정시간2024-08-29T12:51:31.362137Z
createdAt생성시간2024-08-29T12:51:31.362137Z
카테고리ID는 Category API에서 전체 카테고리 정보를 확인 할 수 있다.
브랜드ID는 Brand API에서 전체 브랜드 정보를 확인 할 수 있다.

Sample Data#

pid,name,description,quantity,price,shippingFee,condition,saleStatus,keywords,images,categoryId,brandId,options,uid,updatedAt,createdAt
286843781,에이수스 게이밍 노트북 팔아요,노트북팔아여 미사용입미다,1,1400000,4000,LIKE_NEW,SELLING,"노트북,에이수스","https://media.bunjang.co.kr/product/286843781_1_1724935891_w900.jpg, https://media.bunjang.co.kr/product/286843781_2_1724935891_w900.jpg",600100001,100,"[{""id"":""저장용량"",""value"":""265GB""}]",83370995,2024-08-29T12:51:31.362137Z,2024-08-29T12:51:31.362137Z
286843423,샤넬 보이백,딱 1번 사용했습니다. 무료배송,1,4500000,0,LIKE_NEW,DELETED,"샤넬,보이백","https://media.bunjang.co.kr/product/290074063_1_1726738620_w900.jpg,https://media.bunjang.co.kr/product/290074063_2_1726738620_w900.jpg",430100100,41,,8337099577556686,2024-09-19T18:37:00.469829Z,2024-09-19T18:37:00.469829Z

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Path Params
filename
string 
required
Example:
segment-20241001_00.csv.gz

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://outbound-catalog.bunjang.io/catalog/segment/segment-20241001_00.csv.gz'

Responses

🟢200Success
text/csv
Headers
Content-Encoding
string 
optional
Default:
gzip
Example:
gzip
Body
object {0}
🟠400BAD_REQUEST
Modified at 2025-06-17 07:33:02
Previous
Full Catalog Download
Next
Service Base URL
Built with