일별 베스트셀러 Excel 다운로드
지정한 날짜 기준의 베스트셀러 목록을 Excel 파일로 다운로드합니다.
개요
일별 베스트셀러 Excel 다운로드 API는 지정한 날짜 기준의 베스트셀러 목록을 Excel 파일로 다운로드합니다.
Endpoint
GET
https://apis.yes24.com/v1/category/bestsellerDaily/export
Query Parameters
| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
categoryId |
string | 필수 | - | 카테고리 ID |
date |
string | 선택 | 어제 날짜 | 기준 날짜(yyyy-MM-dd), 생략 시 어제 |
sex |
string | 선택 | A | 성별 필터(A 전체, M 남성, F 여성) |
age |
integer | 선택 | 255 | 연령 필터(255 전체, 10/20/30/40/50/60) |
page |
integer | 선택 | 1 | 페이지 번호 |
pageSize |
integer | 선택 | 100 | 페이지 크기(최대 100) |
Request Example
Shell
curl -X GET "https://apis.yes24.com/v1/category/bestsellerDaily/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_daily_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 파라미터를 입력하세요. |
| 400 | PARAM_002 |
date 파라미터는 yyyy-MM-dd 형식이어야 합니다. |
| 404 | BEST_001 |
베스트셀러 결과가 없습니다. |