특가 베스트셀러 Excel 다운로드
특가 집계 기준의 베스트셀러 목록을 Excel 파일로 다운로드합니다.
개요
특가 베스트셀러 Excel 다운로드 API는 특가 집계 기준의 베스트셀러 목록을 Excel 파일로 다운로드합니다.
Endpoint
GET
https://apis.yes24.com/v1/category/bestsellerDeal/export
Query Parameters
| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
categoryId |
string | 필수 | - | 카테고리 ID |
page |
integer | 선택 | 1 | 페이지 번호 |
pageSize |
integer | 선택 | 100 | 페이지 크기(최대 100) |
Request Example
Shell
curl -X GET "https://apis.yes24.com/v1/category/bestsellerDeal/export?categoryId=001" -H "X-Api-Key: yk_live_YOUR_API_KEY"Response Example
JSON
# Binary Response — Excel 파일 다운로드
Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
Content-Disposition: attachment; filename="bestseller_deal_20260713.xlsx"
# 브라우저에서 호출 시 파일 저장 대화상자가 나타납니다.
# API 클라이언트(Bruno 등)에서는 응답 바이너리를 .xlsx로 저장하세요.Response Fields
| 필드 | 타입 | 설명 |
|---|---|---|
Excel 열 1 | string | 순위 |
Excel 열 2 | string | ISBN13 |
Excel 열 3 | integer | 상품번호 |
Excel 열 4 | string | 제목 |
Excel 열 5 | string | 저자 |
Excel 열 6 | integer | 정가 |
Excel 열 7 | integer | 판매가 |
Excel 열 8 | string | 출판사 |
Excel 열 9 | string | 출간일 |
Excel 열 10 | string | 관리분류 |
오류 코드
| HTTP | 오류 코드 | 설명 |
|---|---|---|
| 401 | AUTH_001 |
X-Api-Key 헤더가 없습니다. |
| 401 | AUTH_002 |
유효하지 않은 API Key입니다. |
| 400 | PARAM_001 |
categoryId 파라미터를 입력하세요. |
| 404 | BEST_001 |
베스트셀러 결과가 없습니다. |