get_bestsellers
Retrieve Aladin Bookstore bestseller lists by category or specific week. Customize results with max results, start number, and year/month/week parameters.
Instructions
알라딘 도서 베스트셀러 목록을 조회합니다. 카테고리별로 검색할 수 있으며, 특정 주간의 베스트셀러를 조회할 수 있습니다. 특정 주간을 조회할 때는 연도, 월, 주를 모두 입력해주세요.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| categoryId | No | 카테고리 ID (CID) - 특정 카테고리로 검색을 제한할 때 사용 | |
| maxResults | No | 최대 결과 개수 | |
| month | No | 조회할 월 (1-12) - 생략하면 현재 주간 | |
| start | No | 검색 시작 번호 | |
| week | No | 조회할 주 (1-5) - 생략하면 현재 주간 | |
| year | No | 조회할 연도 (예: 2025) - 생략하면 현재 주간 |
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"categoryId": {
"description": "카테고리 ID (CID) - 특정 카테고리로 검색을 제한할 때 사용",
"type": "string"
},
"maxResults": {
"default": 10,
"description": "최대 결과 개수",
"maximum": 100,
"minimum": 1,
"type": "number"
},
"month": {
"description": "조회할 월 (1-12) - 생략하면 현재 주간",
"maximum": 12,
"minimum": 1,
"type": "number"
},
"start": {
"default": 1,
"description": "검색 시작 번호",
"minimum": 1,
"type": "number"
},
"week": {
"description": "조회할 주 (1-5) - 생략하면 현재 주간",
"maximum": 5,
"minimum": 1,
"type": "number"
},
"year": {
"description": "조회할 연도 (예: 2025) - 생략하면 현재 주간",
"maximum": 2030,
"minimum": 2000,
"type": "number"
}
},
"type": "object"
}