개요

예스24 Open API를 사용하여 카테고리와 상품 데이터를 애플리케이션에 통합하세요.

예스24 Open API란?

예스24 Open API는 외부 개발자가 예스24의 카테고리, 베스트셀러, 신상품, 상품 정보를 활용하여 서비스를 구축할 수 있도록 제공하는 공식 API입니다.

REST 방식으로 설계되었으며, JSON 형식으로 응답합니다. 발급받은 API Key를 요청 헤더에 포함하는 방식으로 인증합니다.

API	설명	Endpoint
Category API	카테고리 목록, 베스트셀러, 신상품 조회	`/v1/category`
Goods API	상품 검색, 상품 상세, 목차, 작가 정보 조회	`/v1/goods`

모든 API 요청은 아래 Base URL을 사용합니다.

https://apis.yes24.com/v1

구분	일일 요청	비고
기본 정책	20,000회 이하	API Key 기준

Rate Limit 초과 시 HTTP 429 Too Many Requests가 반환됩니다.

모든 응답은 Content-Type: application/json으로 반환됩니다.

json — 성공 응답

{
  "success": true,
  "message": "성공",
  "data": { ... },
  "errorCode": null
}

json — 오류 응답

{
  "success": false,
  "message": "API Key가 없거나 유효하지 않습니다.",
  "data": null,
  "errorCode": "AUTH_001"
}

목록형 API는 page와 pageSize Query Parameter를 사용합니다.

파라미터	기본값	설명
`page`	1	조회할 페이지 번호
`pageSize`	20	페이지당 결과 수, 최대 100