예스24 Open API

예스24 데이터로
서비스를 만들어보세요

도서 검색, 상품 조회, 베스트셀러, 카테고리 데이터를 API로 제공합니다.
공식 문서와 예제로 빠르게 시작할 수 있습니다.

문서 보기
Quick Start

4단계로 API를 시작하세요

신청서 작성부터 첫 API 호출까지 빠르게 시작할 수 있습니다.

01

신청서 작성

API 활용 목적(필수)과 상세 설명(선택)을 입력합니다. 예스24 계정 정보는 자동 연동됩니다.

02

이용약관 동의

이용약관에 필수 동의 후 신청합니다.

03

API Key 즉시 발급

신청 즉시 API Key가 발급됩니다.

04

API 호출

X-Api-Key 헤더에 Key를 넣고 API를 호출합니다.

# 도서 검색 (Goods API)
curl -X GET "https://apis.yes24.com/v1/goods/itemList?query=클린코드&page=1&pageSize=20" \
     -H "X-Api-Key: yk_live_YOUR_API_KEY"
# pip install requests
import requests

url     = "https://apis.yes24.com/v1/goods/itemList"
params  = {"query": "클린코드", "page": 1, "pageSize": 20}
headers = {"X-Api-Key": "yk_live_YOUR_API_KEY"}

res  = requests.get(url, params=params, headers=headers)
data = res.json()
print(data)
// .NET 6+
using var client = new HttpClient();
client.DefaultRequestHeaders.Add(
    "X-Api-Key", "yk_live_YOUR_API_KEY");

var url = "https://apis.yes24.com/v1/goods/itemList"
        + "?query=클린코드&page=1&pageSize=20";

var res  = await client.GetAsync(url);
var json = await res.Content.ReadAsStringAsync();
Console.WriteLine(json);
API CATALOG

예스24 데이터를 직접 연결하세요

Category와 Goods, 두 API의 조합으로 검색·랭킹·상세·목차·작가까지 시나리오를 구성할 수 있습니다.

Category API

카테고리 트리와 카테고리별 베스트/스테디/신상품을 제공합니다.

  • GET /v1/category/list 카테고리 목록
  • GET /v1/category/bestseller 베스트셀러
  • GET /v1/category/newproduct 신상품
  • GET /v1/category/bestsellerSteady 스테디셀러
전체 9개 Endpoint →

Goods API

상품 검색·상세·목차·작가 정보. ISBN13 또는 ItemId 기반 조회.

  • GET /v1/goods/itemList 상품 검색
  • GET /v1/goods/itemDetail 상품 상세
  • GET /v1/goods/author 작가 정보
  • GET /v1/goods/content 목차
전체 4개 Endpoint →
USE CASES

누가, 어떻게 쓰고 있을까요

예스24 Open API는 개인 프로젝트부터 커머스 파트너까지, 다양한 규모의 서비스에서 활용됩니다.

01

개인 개발자

사이드 프로젝트

주말 프로젝트, 학습용 앱, 개인 도서 관리 서비스를 만드는 개발자.

  • 독서 기록 · 위시리스트 앱
  • 도서 검색 챗봇 · MCP 커넥터
  • ISBN 스캐너 앱의 메타 정보 소스
02

출판 · 서점

파트너 사업자

자체 서점 시스템·재고 관리에 예스24 데이터를 연동합니다.

  • 도서 마스터 데이터 동기화
  • 카테고리별 베스트/신상품 큐레이션
  • 목차·작가 정보 자동 채우기
03

블로거 · 크리에이터

애드온

서평·큐레이션 콘텐츠에 애드온 링크로 수익을 연결합니다.

  • 자동 표지·정보 임베드
  • addOnLink로 수익 전환
  • Excel 다운로드로 대량 큐레이션
UPDATES

최근 업데이트

전체 보기 →
안내 Open API 호출 한도 상향 안내 2026-08-13

안녕하세요. 예스24입니다.

예스24 Open API 공개 후 한 달 동안, 많은 개발자와 파트너 여러분께서 다양한 서비스에 연동해 주셨습니다.

보내주신 관심과 성원에 감사드리며, 보다 여유로운 환경에서 활용하실 수 있도록 기본 제공 호출 한도를 대폭 상향합니다.
Basic 등급의 일일 호출량은 4배, 초당 호출량은 2배로 확대되며, Partner 등급의 일일 호출량도 2배로 늘어납니다.

변경 내용

  • Basic — 일일 5,000회 → 20,000회 / 초당 5회 → 10회
  • Partner — 일일 50,000회 → 100,000회 / 초당 20회 (변동 없음)
  • Enterprise — 일일 500,000회 / 초당 50회 (변동 없음)

적용 시점

  • 2026년 8월 13일부터 즉시 적용됩니다.
  • 별도 신청이나 API Key 재발급은 필요하지 않습니다. 기존 API Key에 변경된 한도가 자동으로 적용됩니다.

참고 사항

  • 호출량은 API Key가 아닌 계정 단위로 누적되며, 한국 표준시(KST) 기준 매일 00시에 초기화됩니다.
  • 현재 적용된 호출 한도와 사용량은 이용 현황에서 확인하실 수 있습니다.
  • 상향된 한도를 초과하는 이용이 필요한 경우 1:1 문의로 요청해 주시면 이용 목적과 규모를 확인하여 안내드리겠습니다.

앞으로도 예스24 Open API에 많은 관심과 이용 부탁드립니다.

감사합니다.

안내 예스24 Open API 서비스 일시 중단 안내 2026-08-10

안녕하세요. 예스24입니다.

내부 도서DB 작업으로 인해 예스24 Open API 서비스가 아래와 같이 일시 중단됩니다.

작업 일정

  • 2026년 8월 16일(일) 00:00 ~ 09:00 (약 9시간 소요 예정)
  • 작업 완료 시점에 따라 서비스가 예정 시간보다 일찍 재개될 수 있으며, 재개 시 별도 안내 없이 자동으로 정상화됩니다.

작업 내용 및 영향

  • 위 시간 동안 전체 Open API 이용이 불가하며, API 호출 시 오류가 발생할 수 있습니다.
  • 연동 중이신 서비스가 있다면 사전에 예외 처리 또는 재시도 로직을 점검해 주시기 바랍니다.

보다 안정적인 서비스를 제공하기 위해 최선을 다하겠습니다.
감사합니다.

신규 예스24 Open API 서비스 안내 2026-07-15

예스24의 도서·상품 데이터를 외부 서비스에서 활용할 수 있는 Public API를 제공합니다.

이번 공개 범위에서는 카테고리 목록, 베스트셀러, 스테디셀러, 신상품, 상품 검색, 상품 상세, 상품 목차, 작가 기본 정보 조회 기능을 제공합니다.

  • 모든 API는 REST 방식의 GET 엔드포인트로 제공되며, 응답은 JSON 형식의 공통 구조로 반환됩니다.
  • 목록형 API는 page, pageSize 기반 페이징을 지원합니다.
  • 일부 상품 목록 API는 detail 파라미터로 간단 정보와 상세 정보를 선택할 수 있습니다.
  • 카테고리 및 주요 상품 목록은 Excel 다운로드용 엔드포인트도 함께 제공합니다.
  • 서비스 안정화 작업에 따라 일부 응답 필드나 제공 범위가 조정될 수 있습니다.

API Key 발급, 인증 헤더, 호출 제한, 오류 처리 등 자세한 이용 방법은 문서와 FAQ를 참고해 주세요.